---
title: "GET /v1alpha1/projects/{projectsId}/locations/{locationsId}/contactCenters/{contactCentersId}/phoneNumbers"
method: GET
path: "/v1alpha1/projects/{projectsId}/locations/{locationsId}/contactCenters/{contactCentersId}/phoneNumbers"
tags: ["projects"]
---

# GET /v1alpha1/projects/{projectsId}/locations/{locationsId}/contactCenters/{contactCentersId}/phoneNumbers

`GET /v1alpha1/projects/{projectsId}/locations/{locationsId}/contactCenters/{contactCentersId}/phoneNumbers`

## Request

- Base URL: `https://contactcenteraiplatform.googleapis.com`
- URL: `https://contactcenteraiplatform.googleapis.com/v1alpha1/projects/{projectsId}/locations/{locationsId}/contactCenters/{contactCentersId}/phoneNumbers`
- Auth: OAuth 2 and OAuth 2
  - Implicit: `https://accounts.google.com/o/oauth2/auth`
  - Scopes: `https://www.googleapis.com/auth/cloud-platform`
  - Authorization code: `https://accounts.google.com/o/oauth2/auth`
  - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/cloud-platform`

Lists phone numbers allocated to a single ContactCenter.

## Path parameters

- `projectsId` string, required
- `locationsId` string, required
- `contactCentersId` string, required

## Query parameters

- `pageSize` integer
- `pageToken` string

## Response `200`

Successful response

- ListPhoneNumbersResponse: Response message for ListPhoneNumbers.
  - `nextPageToken` string: Token identifying the next page of results.
  - `phoneNumbers` PhoneNumber[]: The list of phone numbers allocated to the ContactCenter.
    - `assignmentState` 'ASSIGNMENT_STATE_UNSPECIFIED' | 'ASSIGNMENT_STATE_UNASSIGNED' | 'ASSIGNMENT_STATE_ASSIGNED' | 'ASSIGNMENT_STATE_COOLING_OFF' | 'ASSIGNMENT_STATE_PORTING_IN' | 'ASSIGNMENT_STATE_RELEASED': Output only. Current assignment and lifecycle state.
    - `carrier` 'CARRIER_UNSPECIFIED' | 'CARRIER_TWILIO' | 'CARRIER_VONAGE' | 'CARRIER_TELNYX' | 'CARRIER_GTP': Output only. Underlying carrier hosting the number.
    - `complianceState` 'COMPLIANCE_STATE_UNSPECIFIED' | 'COMPLIANCE_STATE_VERIFIED' | 'COMPLIANCE_STATE_LEGACY_VERIFIED' | 'COMPLIANCE_STATE_PENDING' | 'COMPLIANCE_STATE_REJECTED': Output only. Regulatory compliance state.
    - `countryCode` string: Output only. ISO 3166-1 alpha-2 country code (e.g., "US", "GB", "IT").
    - `createTime` string, google-datetime: Output only. Timestamp when the phone number was added to the tenant.
    - `numberType` 'NUMBER_TYPE_UNSPECIFIED' | 'NUMBER_TYPE_LOCAL' | 'NUMBER_TYPE_TOLL_FREE' | 'NUMBER_TYPE_MOBILE' | 'NUMBER_TYPE_NATIONAL': Output only. Tariff and routing classification.
    - `phoneNumber` string: Output only. E.164 formatted phone number (e.g., "+16502530000").
    - `regulatoryBundleId` string: Output only. Reference ID for the country-specific regulatory bundle, or "LEGACY_VERIFIED".
    - `smsState` 'SMS_STATE_UNSPECIFIED' | 'SMS_STATE_DISABLED' | 'SMS_STATE_ENABLED' | 'SMS_STATE_PENDING_REGISTRATION': Output only. SMS capability state.
    - `updateTime` string, google-datetime: Output only. Timestamp when the phone number record was last modified.
    - `voiceEnabled` boolean: Output only. Whether voice capabilities are enabled for this phone number.

## Changes

- **2026-11-10** `181f1ee6bcdb`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/google/apis/contactcenteraiplatform/changes/v1alpha1/projects/:projectsId/locations/:locationsId/contactCenters/:contactCentersId/phoneNumbers/get.md)

---

[API](https://skmtc.dev/google/apis/contactcenteraiplatform.md) - [All operations](https://skmtc.dev/google/apis/contactcenteraiplatform/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/contactcenteraiplatform/revisions/181f1ee6bcdb?raw)