---
title: "GET /voice-connectors/{voiceConnectorId}/proxy-sessions"
method: GET
path: "/voice-connectors/{voiceConnectorId}/proxy-sessions"
---

# GET /voice-connectors/{voiceConnectorId}/proxy-sessions

`GET /voice-connectors/{voiceConnectorId}/proxy-sessions`

Lists the proxy sessions for the specified Amazon Chime SDK Voice Connector.

## Path parameters

- `voiceConnectorId` string, required

## Query parameters

- `status` 'Open' | 'InProgress' | 'Closed'
- `next-token` string
- `max-results` integer

## Response `200`

Success

- ListProxySessionsResponse
  - `ProxySessions` ProxySession[] — The proxy sessions' details.
    - `VoiceConnectorId` string — The Voice Connector ID.
    - `ProxySessionId` string — The proxy session ID.
    - `Name` string — The proxy session name.
    - `Status` 'Open' | 'InProgress' | 'Closed' — The proxy session status.
    - `ExpiryMinutes` integer — The number of minutes allowed for the proxy session.
    - `Capabilities` Capability[] — The proxy session capabilities.
    - `CreatedTimestamp` string, date-time — The created time stamp, in ISO 8601 format.
    - `UpdatedTimestamp` string, date-time — The updated time stamp, in ISO 8601 format.
    - `EndedTimestamp` string, date-time — The ended time stamp, in ISO 8601 format.
    - `Participants` Participant[] — The proxy session participants.
      - `PhoneNumber` string, password — The participant's phone number.
      - `ProxyPhoneNumber` string, password — The participant's proxy phone number.
    - `NumberSelectionBehavior` 'PreferSticky' | 'AvoidSticky' — The preference for proxy phone number reuse, or stickiness, between the same participants across sessions.
    - `GeoMatchLevel` 'Country' | 'AreaCode' — The preference for matching the country or area code of the proxy phone number with that of the first participant.
    - `GeoMatchParams` object — The country and area code for the proxy phone number.
      - `Country` string, required — The country.
      - `AreaCode` string, required — The area code.
  - `NextToken` string — The token used to retrieve the next page of results.

## Other responses

- `480` — UnauthorizedClientException
- `481` — NotFoundException
- `482` — ForbiddenException
- `483` — BadRequestException
- `484` — ThrottledClientException
- `485` — ServiceUnavailableException
- `486` — ServiceFailureException

---

[API](https://skmtc.net/aws/apis/chime-sdk-voice.md) · [All operations](https://skmtc.net/aws/apis/chime-sdk-voice/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/chime-sdk-voice/versions/89ce97d6fad9/schema)