---
title: "GET /peerings"
method: GET
path: "/peerings"
---

# GET /peerings

`GET /peerings`

Lists the peerings for a core network.

## Query parameters

- `coreNetworkId` string
- `peeringType` 'TRANSIT_GATEWAY'
- `edgeLocation` string
- `state` 'CREATING' | 'FAILED' | 'AVAILABLE' | 'DELETING'
- `maxResults` integer
- `nextToken` string
- `MaxResults` string
- `NextToken` string

## Response `200`

Success

- ListPeeringsResponse
  - `Peerings` Peering[] — Lists the transit gateway peerings for the <code>ListPeerings</code> request.
    - `CoreNetworkId` string — The ID of the core network for the peering request.
    - `CoreNetworkArn` string — The ARN of a core network.
    - `PeeringId` string — The ID of the peering attachment.
    - `OwnerAccountId` string — The ID of the account owner.
    - `PeeringType` 'TRANSIT_GATEWAY' — The type of peering. This will be <code>TRANSIT_GATEWAY</code>.
    - `State` 'CREATING' | 'FAILED' | 'AVAILABLE' | 'DELETING' — The current state of the peering connection.
    - `EdgeLocation` string — The edge location for the peer.
    - `ResourceArn` string — The resource ARN of the peer.
    - `Tags` Tag[] — The list of key-value tags associated with the peering.
      - `Key` string — <p>The tag key.</p> <p>Constraints: Maximum length of 128 characters.</p>
      - `Value` string — <p>The tag value.</p> <p>Constraints: Maximum length of 256 characters.</p>
    - `CreatedAt` string, date-time — The timestamp when the attachment peer was created.
  - `NextToken` string — The token for the next page of results.

## Other responses

- `480` — ValidationException
- `481` — AccessDeniedException
- `482` — ThrottlingException
- `483` — InternalServerException

---

[API](https://skmtc.net/aws/apis/networkmanager.md) · [All operations](https://skmtc.net/aws/apis/networkmanager/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/networkmanager/versions/4ea0acef56bf/schema)