Sellers API v1 Use Case Guide

API Version: 1

What is the Sellers API?

The Selling Partner API for Sellers (Sellers API) provides essential information about seller accounts, such as:

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

Refer to the Sellers API reference for details about this API's operations, data types, and schemas.

🚧

Important

The getAccount operation is only available for Sandbox endpoints, and only in the EU marketplace.

Tutorial: Get account information of a seller

Learn how to retrieve account information of a seller.

Prerequisites

To complete this tutorial, you need:

• Authorization from the selling partner for whom you are making calls. Refer to Authorizing Selling Partner API applications for more information.
• Approval for the Finance and Accounting role in your developer profile.
• The Finance and Accounting role selected in the App registration page for your application.
• The marketplace identifier of the marketplace for which you want data. Refer to Marketplace IDs for a list of marketplace identifiers.

Step 1. Retrieve account information

Call the getAccount operation to get information about a seller account.

Request example

GET /sellers/v1/account

Response

Response example

{
  "businessType": "PRIVATE_LIMITED",
  "marketplaceLevelAttributes": [
    {
      "marketplace": {
        "id": "ATVPDKIKX0DER",
        "name": "United States",
        "countryCode": "US",
        "domainName": "www.amazon.com"
      },
      "storeName": "BestSellerStore",
      "listingStatus": "ACTIVE",
      "sellingPlan": "PROFESSIONAL"
    }
  ],
  "business": {
    "name": "BestSeller Inc.",
    "nonLatinName": "ベストセラー株式会社",
    "registeredBusinessAddress": {
      "addressLine1": "123 Main St",
      "addressLine2": "Suite 500",
      "city": "Seattle",
      "stateOrProvinceCode": "WA",
      "postalCode": "98101",
      "countryCode": "US"
    },
    "companyRegistrationNumber": "123456789"
  },
  "primaryContact": {
    "name": "John Doe",
    "nonLatinName": "ジョン・ドゥ",
    "address": {
      "addressLine1": "456 Oak St",
      "addressLine2": "Apt 12",
      "city": "Seattle",
      "stateOrProvinceCode": "WA",
      "postalCode": "98102",
      "countryCode": "US"
    }
  }
}