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

ListMarketplaceParticipations

Returns a list of marketplaces that the seller submitting the request can sell in, and a list of participations that include seller-specific information in that marketplace.

Description

The ListMarketplaceParticipations operation gets a list of marketplaces a seller can participate in and a list of participations that include seller-specific information in that marketplace. Note that the operation returns only those marketplaces where the seller's account is in an active state.

Availability

This operation is available in all marketplaces.

Throttling

The ListMarketplaceParticipations and ListMarketplaceParticipationsByNextToken operations together share a maximum request quota of 15 and a restore rate of one request per minute. 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

None.

Response elements

Name Description
NextToken A generated string used to pass information to your next request. If NextToken is returned, pass the value of NextToken to ListMarketplaceParticipationsByNextToken. If NextToken is not returned, there are no more marketplaces and participations to return.

Optional

Type: xs:string

ListParticipations Detailed information that is specific to a seller in a Marketplace.

Type: List of Participation

ListMarketplaces Detailed information about an Amazon market where a seller can list items for sale and customers can view and purchase items.

Type: List of Marketplace

Examples

Example query request

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

Show example code Hide example code

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

AWSAccessKeyId=ADEAEIERRGENGQCJLSA
&Action=ListMarketplaceParticipations
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&SellerId=ASLLRIDHERE1J56
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2011-07-12T18%3A17%3A58Z
&Version=2011-07-01
&Signature=r9mqm%2BVNEndgZJq%2BiHrFFsMrr2s7N8venKRlRR1CGR8%3D

↑ Top

Example response

For information about standard response formatting, see Response format.

Show example code Hide example code

<?xml version="1.0"?>
<ListMarketplaceParticipationsResponse
    xmlns="https://mws.amazonservices.com/Sellers/2011-07-01">
    <ListMarketplaceParticipationsResult>
        <NextToken>MRgZW55IGNhcm5hbCBwbGVhc3VyZS6=</NextToken>
        <ListParticipations>
            <Participation>
                <MarketplaceId>ATVPDKIKX0DER</MarketplaceId>
                <SellerId>A135KKEKJAIBJ56</SellerId>
                <HasSellerSuspendedListings>No</HasSellerSuspendedListings>
            </Participation>
        </ListParticipations>
        <ListMarketplaces>
            <Marketplace>
                <MarketplaceId>ATVPDKIKX0DER</MarketplaceId>
                <Name>Amazon.com</Name>
                <DefaultCountryCode>US</DefaultCountryCode>
                <DefaultCurrencyCode>USD</DefaultCurrencyCode>
                <DefaultLanguageCode>en_US</DefaultLanguageCode>
                <DomainName>www.amazon.com</DomainName>
            </Marketplace>
        </ListMarketplaces>
    </ListMarketplaceParticipationsResult>
    <ResponseMetadata>
        <RequestId>efeab958-74e2-45d4-9018-2323084413b5</RequestId>
    </ResponseMetadata>
</ListMarketplaceParticipationsResponse>

↑ Top