ListOriginationNumbers - Amazon Simple Notification Service


Lists the calling AWS account's dedicated origination numbers and their metadata. For more information about origination numbers, see Origination numbers in the Amazon SNS Developer Guide.

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.


The maximum number of origination numbers to return.

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 30.

Required: No


Token that the previous ListOriginationNumbers request returns.

Type: String

Required: No

Response Elements

The following elements are returned by the service.


A NextToken string is returned when you call the ListOriginationNumbers operation if additional pages of records are available.

Type: String


A list of the calling account's verified and pending origination numbers.

Type: Array of PhoneNumberInformation objects


For information about the errors that are common to all actions, see Common Errors.


Indicates that the user has been denied access to the requested resource.

HTTP Status Code: 403


Indicates an internal service error.

HTTP Status Code: 500


Indicates that a request parameter does not comply with the associated constraints.

HTTP Status Code: 400


Indicates that the rate at which requests have been submitted for this action exceeds the limit for your Amazon Web Services account.

HTTP Status Code: 429


Indicates that a parameter in the request is invalid.

HTTP Status Code: 400



This example illustrates one usage of ListOriginationNumbers.

Sample Request &NextToken=AAMAATKBfxv6_MR2sl2KtICrU2ksVr9xAtdrIFgK60DYBC7S9uDbQFIkR6ZUugDSulzDRrnUbhQIlq3ZOg%3D%3D &MaxResults=2 &Version=2010-03-31 &AUTHPARAMS

Sample Response

<ListOriginationNumbersResponse xmlns=""> <ListOriginationNumbersResult> <NextToken>eyJBd3NBY2NvdW50SWQiOnsicyI6IjU3MjQ1OTY4NzAxNCJ9LCJEZXN0aW5hdGlvblBob25lTnVtYmVyIjp7InMiOiIrMTc3ODk4NjU0MjkifX0=</NextToken> <PhoneNumbers> <member> <CreatedAt>1611952514</CreatedAt> <Iso2CountryCode>US</Iso2CountryCode> <NumberCapabilities> <member>SMS<member> </NumberCapabilities> <PhoneNumber>+12065550100</PhoneNumber> <RouteType>Transactional</RouteType> <Status>ACTIVE</Status> </member> <member> <CreatedAt>1611952589</CreatedAt> <Iso2CountryCode>CA</Iso2CountryCode> <NumberCapabilities> <member>SMS</member> <member>VOICE</member> </NumberCapabilities> <PhoneNumber>+12065550199</PhoneNumber> <RouteType>Promotional</RouteType> <Status>ACTIVE</Status> </member> </PhoneNumbers> </ListOriginationNumbersResult> <ResponseMetadata> <RequestId>a2430664-0bf0-559e-a20f-5f6bb47ae9b9</RequestId> </ResponseMetadata> </ListOriginationNumbersResponse>

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: