Request Parameters Response Elements Errors Examples See Also

ListOriginationNumbers

Lists the calling Amazon Web Services 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.

MaxResults

The maximum number of origination numbers to return.

Type: Integer

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

Required: No

NextToken

Token that the previous ListOriginationNumbers request returns.

Type: String

Required: No

Response Elements

The following elements are returned by the service.

NextToken

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

Type: String

PhoneNumbers.member.N

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

Type: Array of PhoneNumberInformation objects

Errors

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

AuthorizationError

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

HTTP Status Code: 403

InternalError

Indicates an internal service error.

HTTP Status Code: 500

InvalidParameter

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

HTTP Status Code: 400

Throttled

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

Validation

Indicates that a parameter in the request is invalid.

HTTP Status Code: 400

Examples

Example

This example illustrates one usage of ListOriginationNumbers.

Sample Request


https://sns.us-west-2.amazonaws.com/?Action=ListOriginationNumbers
&NextToken=AAMAATKBfxv6_MR2sl2KtICrU2ksVr9xAtdrIFgK60DYBC7S9uDbQFIkR6ZUugDSulzDRrnUbhQIlq3ZOg%3D%3D
&MaxResults=2
&Version=2010-03-31
&AUTHPARAMS

Sample Response


<ListOriginationNumbersResponse xmlns="https://sns.amazonaws.com/doc/2010-03-31/">
    <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>