---
title: "Get the Direct Connect multi-cloud network configuration across the EMEA, AMER, and APAC macro regions."
method: GET
path: "/v1/multi-cloud-networks"
tags: ["Network"]
---

# Get the Direct Connect multi-cloud network configuration across the EMEA, AMER, and APAC macro regions.

`GET /v1/multi-cloud-networks`

## Request

- Base URL: `https://api.emma.ms/external`
- URL: `https://api.emma.ms/external/v1/multi-cloud-networks`
- Auth: HTTP bearer

Returns the Direct Connect multi-cloud network configuration across the EMEA, AMER, and APAC macro regions.

## Query parameters

- `projectId` integer

## Response `200`

Successful operation

- MultiCloudNetwork
  - `directConnect` object: Multi-cloud network with direct connection
    - `networks` object[]: Network within macro region (AMER, EMEA, or APAC).
      - `id` string: Network ID
      - `macroRegion` 'emea' | 'amer' | 'apac': Macro region of the network
      - `connectivityCenter` object: Connectivity center where the connection point is located.
        - `id` integer: Connectivity center ID
        - `name` string: Connectivity center location
      - `bandwidth` object: Bandwidth and rate limit configuration for the network.
        - `rateLimit` number: Maximum allowed throughput for the connection.
        - `unit` 'Mbps' | 'Gbps': Unit for rateLimit.
      - `cost` object: Pricing information for the network connection.
        - `unit` 'MONTH' | 'YEAR': Billing period for the price.
        - `currency` string: Currency code
        - `price` number: Price for the given billing unit.
      - `status` 'enabled' | 'disabled' | 'enabling' | 'disabling': Operational status of the network.
      - `cloudConnects` object[]: Cloud provider connections available from this Direct Connect network.
        - `id` string: Unique identifier of the cloud connection.
        - `provider` object: Cloud provider for this connection.
          - `id` integer: Numeric identifier of the cloud provider.
          - `name` string: Cloud provider name.
        - `bandwidth` object: Bandwidth and rate limit configuration for the cloud connection.
          - `rateLimit` integer: Maximum allowed throughput for the cloud connection.
          - `unit` 'Mbps' | 'Gbps': Unit for rateLimit.
        - `cost` object: Pricing information for the cloud connection.
          - `unit` string: Billing period for the price.
          - `currency` string: Currency code
          - `price` number: Price for the given billing unit.
        - `status` 'enabled' | 'disabled' | 'enabling' | 'disabling': Operational status of the cloud connection.
    - `crossRegionConnects` object[]: Cross-region links between networks in different macro regions.
      - `id` string: Unique identifier of the cross-region connection.
      - `networks` object[]: Network endpoints participating in the cross-region connection.
        - `id` string: Network ID.
        - `macroRegion` 'emea' | 'amer' | 'apac': Macro region of the referenced network (AMER, EMEA, or APAC).
      - `bandwidth` object: Bandwidth and rate limit configuration for the cross-region connection.
        - `rateLimit` integer: Maximum allowed throughput for the cross-region connection.
        - `unit` 'Mbps' | 'Gbps': Unit for rateLimit.
      - `cost` object: Pricing information for the cross-region connection.
        - `unit` string: Billing period for the price.
        - `currency` string: Currency code
        - `price` number: Price for the given billing unit.
      - `status` 'enabled' | 'disabled': Operational status of the cross-region connection.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `500`: Internal server error

---

[API](https://skmtc.dev/emma/apis/public-emma-api.md) - [All operations](https://skmtc.dev/emma/apis/public-emma-api/llms.txt) - [OpenAPI document](https://skmtc.dev/emma/apis/public-emma-api/revisions/9e55f0920078?raw)