## List interconnect Details

`client.magicTransit.cfInterconnects.get(stringcfInterconnectId, CfInterconnectGetParamsparams, RequestOptionsoptions?): CfInterconnectGetResponse`

**get** `/accounts/{account_id}/magic/cf_interconnects/{cf_interconnect_id}`

Lists details for a specific interconnect.

### Parameters

- `cfInterconnectId: string`

  Identifier

- `params: CfInterconnectGetParams`

  - `account_id: string`

    Path param: Identifier

  - `xMagicNewHcTarget?: boolean`

    Header param: If true, the health check target in the response body will be presented using the new object format. Defaults to false.

### Returns

- `CfInterconnectGetResponse`

  - `interconnect?: Interconnect`

    - `id?: string`

      Identifier

    - `automatic_return_routing?: boolean`

      True if automatic stateful return routing should be enabled for a tunnel, false otherwise.

    - `colo_name?: string`

      The name of the interconnect. The name cannot share a name with other tunnels.

    - `created_on?: string`

      The date and time the tunnel was created.

    - `description?: string`

      An optional description of the interconnect.

    - `gre?: GRE`

      The configuration specific to GRE interconnects.

      - `cloudflare_endpoint?: string`

        The IP address assigned to the Cloudflare side of the GRE tunnel created as part of the Interconnect.

    - `health_check?: HealthCheck`

      - `enabled?: boolean`

        Determines whether to run healthchecks for a tunnel.

      - `rate?: HealthCheckRate`

        How frequent the health check is run. The default value is `mid`.

        - `"low"`

        - `"mid"`

        - `"high"`

      - `target?: MagicHealthCheckTarget | string`

        The destination address in a request type health check. After the healthcheck is decapsulated at the customer end of the tunnel, the ICMP echo will be forwarded to this address. This field defaults to `customer_gre_endpoint address`. This field is ignored for bidirectional healthchecks as the interface_address (not assigned to the Cloudflare side of the tunnel) is used as the target. Must be in object form if the x-magic-new-hc-target header is set to true and string form if x-magic-new-hc-target is absent or set to false.

        - `MagicHealthCheckTarget`

          The destination address in a request type health check. After the healthcheck is decapsulated at the customer end of the tunnel, the ICMP echo will be forwarded to this address. This field defaults to `customer_gre_endpoint address`. This field is ignored for bidirectional healthchecks as the interface_address (not assigned to the Cloudflare side of the tunnel) is used as the target.

          - `effective?: string`

            The effective health check target. If 'saved' is empty, then this field will be populated with the calculated default value on GET requests. Ignored in POST, PUT, and PATCH requests.

          - `saved?: string`

            The saved health check target. Setting the value to the empty string indicates that the calculated default value will be used.

        - `string`

      - `type?: HealthCheckType`

        The type of healthcheck to run, reply or request. The default value is `reply`.

        - `"reply"`

        - `"request"`

    - `interface_address?: string`

      A 31-bit prefix (/31 in CIDR notation) supporting two hosts, one for each side of the tunnel. Select the subnet from the following private IP space: 10.0.0.0–10.255.255.255, 172.16.0.0–172.31.255.255, 192.168.0.0–192.168.255.255.

    - `interface_address6?: string`

      A 127 bit IPV6 prefix from within the virtual_subnet6 prefix space with the address being the first IP of the subnet and not same as the address of virtual_subnet6. Eg if virtual_subnet6 is 2606:54c1:7:0:a9fe:12d2::/127 , interface_address6 could be 2606:54c1:7:0:a9fe:12d2:1:200/127

    - `modified_on?: string`

      The date and time the tunnel was last modified.

    - `mtu?: number`

      The Maximum Transmission Unit (MTU) in bytes for the interconnect. The minimum value is 576.

    - `name?: string`

      The name of the interconnect. The name cannot share a name with other tunnels.

    - `virtual_port_reservation_id?: string`

      An identifier that correlates this interconnect with the corresponding V2 CNI interconnect resource.

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const cfInterconnect = await client.magicTransit.cfInterconnects.get(
  '023e105f4ecef8ad9ca31a8372d0c353',
  { account_id: '023e105f4ecef8ad9ca31a8372d0c353' },
);

console.log(cfInterconnect.interconnect);
```

#### Response

```json
{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "result": {
    "interconnect": {
      "id": "c4a7362d577a6c3019a474fd6f485821",
      "automatic_return_routing": true,
      "colo_name": "pni_ord",
      "created_on": "2017-06-14T00:00:00Z",
      "description": "Tunnel for Interconnect to ORD",
      "gre": {
        "cloudflare_endpoint": "203.0.113.1"
      },
      "health_check": {
        "enabled": true,
        "rate": "low",
        "target": {
          "effective": "203.0.113.1",
          "saved": "203.0.113.1"
        },
        "type": "request"
      },
      "interface_address": "192.0.2.0/31",
      "interface_address6": "2606:54c1:7:0:a9fe:12d2:1:200/127",
      "modified_on": "2017-06-14T05:20:00Z",
      "mtu": 0,
      "name": "pni_ord",
      "virtual_port_reservation_id": "c4a7362d577a6c3019a474fd6f485821"
    }
  },
  "success": true
}
```