Sellers API v1 Use Case Guide

The Selling Partner API for Sellers (Sellers API) provides information about seller accounts and marketplaces. The returned information includes:

• The marketplaces in which the seller can list items
• The default language and currency of a marketplace
• Whether the seller has suspended listings
• Business information of the seller

For details about the operations, data types, and schemas of the Sellers API, refer to Sellers API v1 Reference.

Tutorial: Get the account information of a seller (EU only)

Learn how to retrieve the account information of a seller. The information that you retrieve includes a list of marketplace participations, business information, and selling plan details. This is only available in the EU region.

Prerequisites

To complete this tutorial, you must complete the following prerequisites:

• The selling partner must authorize you to call the Selling Partner API (SP-API) on their behalf. For details about how selling partners can authorize an application to call the SP-API on their behalf, refer to Authorizing Selling Partner API Applications.
• Your developer profile must include the Finance and Accounting role. To learn about roles, refer to Roles in the Selling Partner API.
• The app registration page for your application must include the Finance and Accounting role.

Get account information

Call the getAccount operation.

Tutorial: Get the market participation of a seller

Learn how to get a list of Amazon marketplaces in which the seller can list items. The information that you retrieve includes marketplace information, the seller's store name in the marketplace, whether the seller participates in the marketplace, and whether the seller has suspended listings in the marketplace.

Prerequisites

To complete this tutorial, you must complete the following prerequisites:

• The selling partner must authorize you to call the Selling Partner API (SP-API) on their behalf. For details about how selling partners can authorize an application to call the SP-API on their behalf, refer to Authorizing Selling Partner API Applications.
• Your developer profile must include the Finance and Accounting role. To learn about roles, refer to Roles in the Selling Partner API.
• The app registration page for your application must include the Finance and Accounting role.
• The marketplace identifier of the marketplace for which you want data. For a list of marketplace identifiers, refer to Marketplace IDs.

Get marketplace participation

Call the getMarketplaceParticipations operation.