HomeDocumentationCode SamplesAPI ReferenceAnnouncementsModelsRelease NotesFAQGitHubVideos
Developer HubAPI StatusSupport
Documentation
Developer HubAPI StatusSupport

Sellers API v1 Use Case Guide

Retrieve seller account information.

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.

Warning

The getAccount operation is currently in beta. To avoid errors and unexpected behavior, do not use this operation until it is released for general availability.

Tutorial: Get account information of a seller

Learn how to retrieve account information of a seller.

Prerequisites

To complete this tutorial, you need:

Step 1. Retrieve account information

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

Request example

GET /sellers/v1/account

Response

NameDescriptionSchema
marketplaceLevelAttributesA list of details of the marketplaces where the seller account is active.< MarketplaceLevelAttributes > array
businessTypeThe type of business registered for the seller account.enum (BusinessType)
businessInformation about the seller's business. Certain fields may be omitted depending on the seller's businessType.Business
primaryContactInformation about the seller's primary contact.PrimaryContact

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"
    }
  }
}