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:
- 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
Name | Description | Schema |
---|---|---|
marketplaceLevelAttributes | A list of details of the marketplaces where the seller account is active. | < MarketplaceLevelAttributes > array |
businessType | The type of business registered for the seller account. | enum (BusinessType ) |
business | Information about the seller's business. Certain fields may be omitted depending on the seller's businessType . | Business |
primaryContact | Information 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"
}
}
}
Updated 10 days ago