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

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

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

## Request

- Base URL: `https://contactcenteraiplatform.googleapis.com`
- URL: `https://contactcenteraiplatform.googleapis.com/v1alpha1/projects/{projectsId}/locations/{locationsId}/contactCenters`
- 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`
- TypeScript: <https://skmtc.dev/google/apis/contactcenteraiplatform/docs/v1alpha1/projects/:projectsId/locations/:locationsId/contactCenters/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists ContactCenters in a given project and location.

## Path parameters

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

## Query parameters

- `filter` string
- `orderBy` string
- `pageSize` integer
- `pageToken` string

## Response `200`

Successful response

- ListContactCentersResponse: Message for response to listing ContactCenters
  - `contactCenters` ContactCenter[]: The list of ContactCenter
    - `adminUser` AdminUser: Message storing info about the first admin user. Next ID: 3
      - `familyName` string: Optional. Last/family name of the first admin user.
      - `givenName` string: Optional. First/given name of the first admin user.
    - `advancedReportingEnabled` boolean: Optional. Whether the advanced reporting feature is enabled.
    - `ccaipManagedUsers` boolean: Optional. Whether to enable users to be created in the CCAIP-instance concurrently to having users in Cloud identity
    - `createTime` string, google-datetime: Output only. [Output only] Create time stamp
    - `critical` Critical: Instances in this Channel will receive updates after all instances in `Normal` were updated. They also will only be updated outside of their peak hours.
      - `peakHours` WeeklySchedule[]: Required. Hours during which the instance should not be updated.
        - `days` string[]: Required. Days of the week this schedule applies to.
        - `duration` string, google-duration: Optional. Duration of the schedule.
        - `endTime` TimeOfDay: Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`.
          - `hours` integer: Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or equal to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time.
          - `minutes` integer: Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59.
          - `nanos` integer: Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999.
          - `seconds` integer: Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An API may allow the value 60 if it allows leap-seconds.
        - `startTime` TimeOfDay: Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`.
          - `hours` integer: Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or equal to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time.
          - `minutes` integer: Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59.
          - `nanos` integer: Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999.
          - `seconds` integer: Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An API may allow the value 60 if it allows leap-seconds.
    - `customerDomainPrefix` string: Required. Immutable. At least 2 and max 16 char long, must conform to [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt).
    - `deleteTime` string, google-datetime: Output only. Timestamp in UTC of when this resource was soft-deleted.
    - `displayName` string: Required. A user friendly name for the ContactCenter.
    - `early` Early: LINT.IfChange First Channel to receive the updates. Meant to dev/test instances
    - `expireTime` string, google-datetime: Output only. Timestamp in UTC of when this resource is considered expired.
    - `featureConfig` FeatureConfig
      - `agentDesktopEnabled` boolean: Optional. If true - enables the agent desktop feature. Default is false.
    - `instanceConfig` InstanceConfig: Message storing the instance configuration.
      - `instanceSize` 'INSTANCE_SIZE_UNSPECIFIED' | 'STANDARD_SMALL' | 'STANDARD_MEDIUM' | 'STANDARD_LARGE' | 'STANDARD_XLARGE' | 'STANDARD_2XLARGE' | 'STANDARD_3XLARGE' | 'MULTIREGION_SMALL' | 'MULTIREGION_MEDIUM' | 'MULTIREGION_LARGE' | 'MULTIREGION_XLARGE' | 'MULTIREGION_2XLARGE' | 'MULTIREGION_3XLARGE' | 'DEV_SMALL' | 'SANDBOX_SMALL' | 'TRIAL_SMALL' | 'TIME_LIMITED_TRIAL_SMALL': The instance size of this the instance configuration.
    - `kmsKey` string: Immutable. The KMS key name to encrypt the user input (`ContactCenter`).
    - `labels` object: Labels as key value pairs
    - `name` string: name of resource
    - `normal` Normal: Instances in this Channel will receive updates after all instances in `Early` were updated + 2 days.
    - `privateAccess` PrivateAccess: Defines ingress and egress private traffic settings for CCAIP instances.
      - `egressSettings` Component[]: List of egress components that should not be accessed via the Internet. For more information see go/ccaip-private-path-v2.
        - `name` string: Name of the component.
        - `serviceAttachmentNames` string[]: Associated service attachments. The service attachment names that will be used for sending private traffic to the CCAIP tenant project. Example service attachment name: "projects/${TENANT_PROJECT_ID}/regions/${REGION}/serviceAttachments/ingress-default".
      - `ingressSettings` Component[]: List of ingress components that should not be accessed via the Internet. For more information see go/ccaip-private-path-v2.
        - `name` string: Name of the component.
        - `serviceAttachmentNames` string[]: Associated service attachments. The service attachment names that will be used for sending private traffic to the CCAIP tenant project. Example service attachment name: "projects/${TENANT_PROJECT_ID}/regions/${REGION}/serviceAttachments/ingress-default".
      - `pscSetting` PscSetting: Private service connect settings.
        - `allowedConsumerProjectIds` string[]: The list of project ids that are allowed to send traffic to the service attachment. This field should be filled only for the ingress components.
        - `producerProjectIds` string[]: Output only. The CCAIP tenant project ids.
    - `privateComponents` string[]: Output only. TODO(b/283407860) Deprecate this field.
    - `purgeTime` string, google-datetime: Output only. Timestamp in UTC of when this resource is going to be hard-deleted.
    - `releaseVersion` string: Output only. UJET release version, unique for each new release.
    - `samlParams` SAMLParams: Message storing SAML params to enable Google as IDP.
      - `authenticationContexts` string[]: Additional contexts used for authentication.
      - `certificate` string: SAML certificate
      - `emailMapping` string: IdP field that maps to the user’s email address
      - `entityId` string: Entity id URL
      - `ssoUri` string: Single sign-on URL
      - `userEmail` string: Email address of the first admin users.
    - `state` 'STATE_UNSPECIFIED' | 'STATE_DEPLOYING' | 'STATE_DEPLOYED' | 'STATE_TERMINATING' | 'STATE_FAILED' | 'STATE_TERMINATING_FAILED' | 'STATE_TERMINATED' | 'STATE_IN_GRACE_PERIOD' | 'STATE_FAILING_OVER' | 'STATE_DEGRADED' | 'STATE_REPAIRING' | 'STATE_EXPIRING': Output only. The state of this contact center.
    - `updateTime` string, google-datetime: Output only. [Output only] Update time stamp
    - `uris` URIs: Message storing the URIs of the ContactCenter.
      - `chatBotUri` string: Chat Bot Uri of the ContactCenter
      - `mediaUri` string: Media Uri of the ContactCenter.
      - `rootUri` string: Root Uri of the ContactCenter.
      - `virtualAgentStreamingServiceUri` string: Virtual Agent Streaming Service Uri of the ContactCenter.
    - `userEmail` string: Optional. Email address of the first admin user.
  - `nextPageToken` string: A token identifying a page of results the server should return.
  - `unreachable` string[]: Locations that could not be reached.

---

[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)