Amazon Services
Amazon Marketplace Web Service (Amazon MWS) Documentation

Deprecation Notice:

Amazon Marketplace Web Service (MWS) will no longer be available after March 31, 2024. All MWS developers must migrate to Selling Partner API (SP-API) to avoid service disruptions. Refer to the Migration Hub for more information.

Amazon MWS Documentation

GetSubscription

Gets the subscription for the specified notification type and destination.

Description

The GetSubscription operation returns the Subscription object for the given NotificationType and Destination.

Availability

This operation is available in all marketplaces except Mexico.

Throttling

Maximum request quota Restore rate Hourly request quota
25 requests Two requests every second 7200 requests per hour
For definitions of throttling terminology and for a complete explanation of throttling, see Throttling: Limits to how often you can submit requests in the Amazon MWS Developer Guide.

Request parameters

For more information about the request parameters that are required for all Amazon MWS operations, see Required request parameters in the Amazon MWS Developer Guide.

Name Description Required Valid values
MarketplaceId The unique identifier for the marketplace. Yes Any valid MarketplaceId that you are registered in. For a list of MarketplaceId values, see Amazon MWS endpoints and MarketplaceId values in the Amazon MWS Developer Guide.

Type: xs:string

NotificationType The notification type of the subscription to retrieve. Yes For NotificationType values, see NotificationType enumeration.

Type: xs:string

Destination The Destination of the subscription to retrieve. Yes Any valid Destination that you previously registered by calling the RegisterDestination operation.

Type: Destination

Response elements

Name Description
Subscription The Subscription object for the specified NotificationType and Destination.

Type: Subscription

Examples

Example query request

For information about standard request requirements, see Required request parameters.

Show example code Hide example code

POST /Subscriptions/2013-07-01 HTTP/1.1
Content-Type: x-www-form-urlencoded
Host: mws.amazonservices.com
User-Agent: <Your User Agent Header>

AWSAccessKeyId=AKIAEEXAMPLENGQCJLSA
&Action=GetSubscription
&Destination.AttributeList.member.1.Key=sqsQueueUrl
&Destination.AttributeList.member.1.Value=
  https%3A%2F%2Fsqs.us-east-1.amazonaws.com%2F51471EXAMPLE%2Fmws_notifications
&Destination.DeliveryChannel=SQS
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&MarketplaceId=ATVPDKIKX0DER
&NotificationType=AnyOfferChanged
&SellerId=A135KEXAMPLE56
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2013-07-25T16%3A39%3A03Z
&Version=2013-07-01
&Signature=ePApMEXAMPLEnfctXl4wQMWa%2FdZn8MF%2BbIvGBHeDklM%3D

↑ Top

Example response

For information about standard response formatting, see Response format.

Show example code Hide example code

<GetSubscriptionResponse
    xmlns="http://mws.amazonservices.com/schema/Subscriptions/2013-07-01">
    <GetSubscriptionResult>
        <Subscription>
            <NotificationType>AnyOfferChanged</NotificationType>
            <IsEnabled>true</IsEnabled>
            <Destination>
                <DeliveryChannel>SQS</DeliveryChannel>
                <AttributeList>
                    <member>
                        <Value>
                            https://sqs.us-east-1.amazonaws.com/51471EXAMPLE/mws_notifications
                        </Value>
                        <Key>sqsQueueUrl</Key>
                    </member>
                </AttributeList>
            </Destination>
        </Subscription>
    </GetSubscriptionResult>
    <ResponseMetadata>
        <RequestId>4012b1ae-3f31-4627-83c3-1757aEXAMPLE</RequestId>
    </ResponseMetadata>
</GetSubscriptionResponse>

↑ Top