http://service.chime.aws.amazon.com/search#type=phone-numbersSearches for phone numbers that can be ordered. For US numbers, provide at least one of the following search filters: <code>AreaCode</code>, <code>City</code>, <code>State</code>, or <code>TollFreePrefix</code>. If you provide <code>City</code>, you must also provide <code>State</code>. Numbers outside the US only support the <code>PhoneNumberType</code> filter, which you must use.
The area code used to filter results. Only applies to the US.
The city used to filter results. Only applies to the US.
The country used to filter results. Defaults to the US Format: ISO 3166-1 alpha-2.
The state used to filter results. Required only if you provide <code>City</code>. Only applies to the US.
The toll-free prefix that you use to filter results. Only applies to the US.
The phone number type used to filter results. Required for non-US numbers.
The maximum number of results to return in a single call.
The token used to retrieve the next page of results.
Pagination limit
Pagination token
{
"success": true,
"data": {
"id": "abc123",
"created_at": "2025-01-01T00:00:00Z"
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request parameters"
}
}1curl --request GET \2 --url 'http://service.chime.aws.amazon.com/search#type=phone-numbers' \3 --header 'accept: application/json' \4 --header 'content-type: application/json'1{2 "success": true,3 "data": {4 "id": "abc123",5 "created_at": "2025-01-01T00:00:00Z"6 }7}http://service.chime.aws.amazon.com/search#type=phone-numbersSearches for phone numbers that can be ordered. For US numbers, provide at least one of the following search filters: <code>AreaCode</code>, <code>City</code>, <code>State</code>, or <code>TollFreePrefix</code>. If you provide <code>City</code>, you must also provide <code>State</code>. Numbers outside the US only support the <code>PhoneNumberType</code> filter, which you must use.
The area code used to filter results. Only applies to the US.
The city used to filter results. Only applies to the US.
The country used to filter results. Defaults to the US Format: ISO 3166-1 alpha-2.
The state used to filter results. Required only if you provide <code>City</code>. Only applies to the US.
The toll-free prefix that you use to filter results. Only applies to the US.
The phone number type used to filter results. Required for non-US numbers.
The maximum number of results to return in a single call.
The token used to retrieve the next page of results.
Pagination limit
Pagination token
{
"success": true,
"data": {
"id": "abc123",
"created_at": "2025-01-01T00:00:00Z"
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request parameters"
}
}1curl --request GET \2 --url 'http://service.chime.aws.amazon.com/search#type=phone-numbers' \3 --header 'accept: application/json' \4 --header 'content-type: application/json'1{2 "success": true,3 "data": {4 "id": "abc123",5 "created_at": "2025-01-01T00:00:00Z"6 }7}