# ListPhoneNumbersV2
<a name="API_ListPhoneNumbersV2"></a>

Lists phone numbers claimed to your Amazon Connect instance or traffic distribution group. If the provided `TargetArn` is a traffic distribution group, you can call this API in both AWS Regions associated with traffic distribution group.

For more information about phone numbers, see [Set Up Phone Numbers for Your Contact Center](https://docs.aws.amazon.com/connect/latest/adminguide/contact-center-phone-number.html) in the *Amazon Connect Administrator Guide*.

**Note**  
When given an instance ARN, `ListPhoneNumbersV2` returns only the phone numbers claimed to the instance.
When given a traffic distribution group ARN `ListPhoneNumbersV2` returns only the phone numbers claimed to the traffic distribution group.

## Request Syntax
<a name="API_ListPhoneNumbersV2_RequestSyntax"></a>

```
POST /phone-number/list HTTP/1.1
Content-type: application/json

{
   "InstanceId": "string",
   "MaxResults": number,
   "NextToken": "string",
   "PhoneNumberCountryCodes": [ "string" ],
   "PhoneNumberPrefix": "string",
   "PhoneNumberTypes": [ "string" ],
   "TargetArn": "string"
}
```

## URI Request Parameters
<a name="API_ListPhoneNumbersV2_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_ListPhoneNumbersV2_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [InstanceId](#API_ListPhoneNumbersV2_RequestSyntax) **   <a name="connect-ListPhoneNumbersV2-request-InstanceId"></a>
The identifier of the Amazon Connect instance that phone numbers are claimed to. You can [find the instance ID](https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html) in the Amazon Resource Name (ARN) of the instance. If both `TargetArn` and `InstanceId` are not provided, this API lists numbers claimed to all the Amazon Connect instances belonging to your account in the same AWS Region as the request.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 100.  
Required: No

 ** [MaxResults](#API_ListPhoneNumbersV2_RequestSyntax) **   <a name="connect-ListPhoneNumbersV2-request-MaxResults"></a>
The maximum number of results to return per page.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 1000.  
Required: No

 ** [NextToken](#API_ListPhoneNumbersV2_RequestSyntax) **   <a name="connect-ListPhoneNumbersV2-request-NextToken"></a>
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.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 100000.  
Required: No

 ** [PhoneNumberCountryCodes](#API_ListPhoneNumbersV2_RequestSyntax) **   <a name="connect-ListPhoneNumbersV2-request-PhoneNumberCountryCodes"></a>
The ISO country code.  
Type: Array of strings  
Array Members: Maximum number of 10 items.  
Valid Values: `AF | AL | DZ | AS | AD | AO | AI | AQ | AG | AR | AM | AW | AU | AT | AZ | BS | BH | BD | BB | BY | BE | BZ | BJ | BM | BT | BO | BA | BW | BR | IO | VG | BN | BG | BF | BI | KH | CM | CA | CV | KY | CF | TD | CL | CN | CX | CC | CO | KM | CK | CR | HR | CU | CW | CY | CZ | CD | DK | DJ | DM | DO | TL | EC | EG | SV | GQ | ER | EE | ET | FK | FO | FJ | FI | FR | PF | GA | GM | GE | DE | GH | GI | GR | GL | GD | GU | GT | GG | GN | GW | GY | HT | HN | HK | HU | IS | IN | ID | IR | IQ | IE | IM | IL | IT | CI | JM | JP | JE | JO | KZ | KE | KI | KW | KG | LA | LV | LB | LS | LR | LY | LI | LT | LU | MO | MK | MG | MW | MY | MV | ML | MT | MH | MR | MU | YT | MX | FM | MD | MC | MN | ME | MS | MA | MZ | MM | NA | NR | NP | NL | AN | NC | NZ | NI | NE | NG | NU | KP | MP | NO | OM | PK | PW | PA | PG | PY | PE | PH | PN | PL | PT | PR | QA | CG | RE | RO | RU | RW | BL | SH | KN | LC | MF | PM | VC | WS | SM | ST | SA | SN | RS | SC | SL | SG | SX | SK | SI | SB | SO | ZA | KR | ES | LK | SD | SR | SJ | SZ | SE | CH | SY | TW | TJ | TZ | TH | TG | TK | TO | TT | TN | TR | TM | TC | TV | VI | UG | UA | AE | GB | US | UY | UZ | VU | VA | VE | VN | WF | EH | YE | ZM | ZW`   
Required: No

 ** [PhoneNumberPrefix](#API_ListPhoneNumbersV2_RequestSyntax) **   <a name="connect-ListPhoneNumbersV2-request-PhoneNumberPrefix"></a>
The prefix of the phone number. If provided, it must contain `+` as part of the country code.  
Type: String  
Pattern: `\\+?[0-9]{1,11}`   
Required: No

 ** [PhoneNumberTypes](#API_ListPhoneNumbersV2_RequestSyntax) **   <a name="connect-ListPhoneNumbersV2-request-PhoneNumberTypes"></a>
The type of phone number.  
Type: Array of strings  
Array Members: Maximum number of 6 items.  
Valid Values: `TOLL_FREE | DID | UIFN | SHARED | THIRD_PARTY_TF | THIRD_PARTY_DID | SHORT_CODE`   
Required: No

 ** [TargetArn](#API_ListPhoneNumbersV2_RequestSyntax) **   <a name="connect-ListPhoneNumbersV2-request-TargetArn"></a>
The Amazon Resource Name (ARN) for Amazon Connect instances or traffic distribution groups that phone number inbound traffic is routed through. If both `TargetArn` and `InstanceId` input are not provided, this API lists numbers claimed to all the Amazon Connect instances belonging to your account in the same AWS Region as the request.  
Type: String  
Required: No

## Response Syntax
<a name="API_ListPhoneNumbersV2_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ListPhoneNumbersSummaryList": [ 
      { 
         "InstanceId": "string",
         "PhoneNumber": "string",
         "PhoneNumberArn": "string",
         "PhoneNumberCountryCode": "string",
         "PhoneNumberDescription": "string",
         "PhoneNumberId": "string",
         "PhoneNumberType": "string",
         "SourcePhoneNumberArn": "string",
         "TargetArn": "string"
      }
   ],
   "NextToken": "string"
}
```

## Response Elements
<a name="API_ListPhoneNumbersV2_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [ListPhoneNumbersSummaryList](#API_ListPhoneNumbersV2_ResponseSyntax) **   <a name="connect-ListPhoneNumbersV2-response-ListPhoneNumbersSummaryList"></a>
Information about phone numbers that have been claimed to your Amazon Connect instances or traffic distribution groups.  
Type: Array of [ListPhoneNumbersSummary](API_ListPhoneNumbersSummary.md) objects

 ** [NextToken](#API_ListPhoneNumbersV2_ResponseSyntax) **   <a name="connect-ListPhoneNumbersV2-response-NextToken"></a>
If there are additional results, this is the token for the next set of results.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 100000.

## Errors
<a name="API_ListPhoneNumbersV2_Errors"></a>

For information about the errors that are common to all actions, see [Common Errors](CommonErrors.md).

 ** AccessDeniedException **   
You do not have sufficient permissions to perform this action.  
HTTP Status Code: 403

 ** InternalServiceException **   
Request processing failed because of an error or failure with the service.    
 ** Message **   
The message.
HTTP Status Code: 500

 ** InvalidParameterException **   
One or more of the specified parameters are not valid.    
 ** Message **   
The message about the parameters.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The specified resource was not found.    
 ** Message **   
The message about the resource.
HTTP Status Code: 404

 ** ThrottlingException **   
The throttling limit has been exceeded.  
HTTP Status Code: 429

## See Also
<a name="API_ListPhoneNumbersV2_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/connect-2017-08-08/ListPhoneNumbersV2) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/connect-2017-08-08/ListPhoneNumbersV2) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/connect-2017-08-08/ListPhoneNumbersV2) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/connect-2017-08-08/ListPhoneNumbersV2) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/connect-2017-08-08/ListPhoneNumbersV2) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/connect-2017-08-08/ListPhoneNumbersV2) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/connect-2017-08-08/ListPhoneNumbersV2) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/connect-2017-08-08/ListPhoneNumbersV2) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/connect-2017-08-08/ListPhoneNumbersV2) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/connect-2017-08-08/ListPhoneNumbersV2)