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.
Gets the subscription for the specified notification type and destination.
The GetSubscription operation returns the Subscription object for the given NotificationType and Destination.
This operation is available in all marketplaces except Mexico.
Maximum request quota | Restore rate | Hourly request quota |
---|---|---|
25 requests | Two requests every second | 7200 requests per hour |
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 |
Name | Description |
---|---|
Subscription | The Subscription object for the specified
NotificationType and
Destination. Type: Subscription |
For information about standard request requirements, see Required request parameters.
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
For information about standard response formatting, see Response format.
<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>