v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-14171791756.1 KB

Provides information about the phone numbers for the specified Amazon Connect instance.

For more information about phone numbers, see Set Up Phone Numbers for Your Contact Center in the Amazon Connect Administrator Guide.

The phone number Arn value that is returned from each of the items in the PhoneNumberSummaryList cannot be used to tag phone number resources. It will fail with a ResourceNotFoundException. Instead, use the ListPhoneNumbersV2 API. It returns the new phone number ARN that can be used to tag phone number resources.

get/phone-numbers-summary/{InstanceId}

Path parameters

InstanceIdstring required

The identifier of the Amazon Connect instance. You can <a href="https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html">find the instance ID</a> in the Amazon Resource Name (ARN) of the instance.

Query parameters

phoneNumberTypesPhoneNumberType[]

The type of phone number.

phoneNumberCountryCodesPhoneNumberCountryCode[]

The ISO country code.

nextTokenstring

The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.

maxResultsinteger

The maximum number of results to return per page. The default MaxResult size is 100.

MaxResultsstring

Pagination limit

NextTokenstring

Pagination token

Response

Success

NextTokenstring

If there are additional results, this is the token for the next set of results.