---
title: "List Virtual Cross Connect Cloud Coverage"
method: GET
path: "/virtual_cross_connects/coverage"
tags: ["Virtual Cross Connects"]
---

# List Virtual Cross Connect Cloud Coverage

`GET /virtual_cross_connects/coverage`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/virtual_cross_connects/coverage`
- Auth: HTTP bearer

List Virtual Cross Connects Cloud Coverage.<br /><br />This endpoint shows which cloud regions are available for the `location_code` your Virtual Cross Connect will be provisioned in.

## Query parameters

- `filters` object
  - `available_bandwidth` union
    - integer: Filter by exact available bandwidth match
    - object: Available bandwidth filtering operations
      - `contains` integer: Filter by available bandwidth containing the specified value
- `filter` object
  - `cloud_provider` 'aws' | 'azure' | 'gce': The Virtual Private Cloud provider.
  - `cloud_provider_region` string: The region of specific cloud provider.
  - `location.region` string: The region of associated location to filter on.
  - `location.site` string: The site of associated location to filter on.
  - `location.pop` string: The POP of associated location to filter on.
  - `location.code` string: The code of associated location to filter on.
- `page` object
  - `number` integer: The page number to load
  - `size` integer: The size of the page

## Response `200`

Successful response

- object
  - `data` VirtualCrossConnectCoverage[]
    - `record_type` string: Identifies the type of the resource.
    - `location` NetappsLocation
      - `region` string: Identifies the geographical region of location.
      - `site` string: Site of location.
      - `pop` string: Point of presence of location.
      - `code` string: Location code.
      - `name` string: Human readable name of location.
    - `cloud_provider` 'aws' | 'azure' | 'gce': The Virtual Private Cloud with which you would like to establish a cross connect.
    - `cloud_provider_region` string: The region where your Virtual Private Cloud hosts are located. Should be identical to how the cloud provider names region, i.e. us-east-1 for AWS but Frankfurt for Azure
    - `available_bandwidth` number[]: The available throughput in Megabits per Second (Mbps) for your Virtual Cross Connect.
  - `meta` PaginationMeta
    - `total_pages` integer
    - `total_results` integer
    - `page_number` integer
    - `page_size` integer

## Other responses

- `422`: Unexpected error
- `default`: Unexpected error

## Changes

- **2026-10-15** `a72569d69430`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api/changes/virtual_cross_connects/coverage/get.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api/revisions/a73101b68823?raw)