Update: Sellers API now supports the ability to retrieve account information
Amazon's Selling Partner API now includes a sandbox‑only getAccount operation (GET https://sandbox.sellingpartnerapi‑na.amazon.com/sellers/v1/account). It returns each authorized marketplace with marketplaceId, defaultLanguageCode, defaultCurrencyCode and an isSuspended flag, enabling automated account verification and suspension checks.
Overview
Amazon’s Selling Partner API now includes a getAccount operation that lets developers pull a seller’s core account data through a programmatic call. The endpoint, which is currently available only in the sandbox, returns the list of marketplaces a seller can list in, the default language and currency for each marketplace, and a flag that shows whether listings are suspended. Sellers and solution providers can use this information to automate account verification and prevent feed errors before moving to a live environment.
Key Points
- Sandbox‑only availability — The new
getAccountcall can be reached exclusively via sandbox URLs, allowing developers to test account‑retrieval logic without impacting real listings. - Full marketplace list — The response enumerates every marketplace (for example US, DE, JP) that the seller is authorized to sell in, enabling dynamic adjustment of catalog feeds per region.
- Locale defaults — Each marketplace entry supplies a default language code such as en‑US and a default currency code such as USD, which can be used to format titles and prices automatically.
- Suspension indicator — A Boolean field (
isSuspended) tells whether the seller’s listings are currently blocked in a particular marketplace, allowing integrations to pause uploads pre‑emptively. - Predictable JSON structure — The payload follows a consistent schema with fields like
marketplaceId,defaultLanguageCode,defaultCurrencyCode, andisSuspended, simplifying parsing in Java, Python, Node, or other languages. - Future production rollout — Amazon has indicated that the same operation will later be enabled on live endpoints, meaning code written against the sandbox can be switched to production with only a URL change.
How the getAccount Operation Works
- Create a signed request — Using AWS Signature Version 4, the backend generates a signed GET request to , inserting the developer’s access key, secret key, and region information. For instance, a test app might sign the request with the key .
Analysis & Recommendations
Why This Matters
Sellers can programmatically pull marketplace IDs, locale defaults and suspension status, eliminating manual checks in Seller Central. This reduces feed errors, automates suspension alerts, and ensures correct currency and language handling for each region, improving listing accuracy and support efficiency.
Key Takeaways
- The new getAccount call is reachable at https://sandbox.sellingpartnerapi‑na.amazon.com/sellers/v1/account (sandbox‑only).
- Response includes marketplaceId, defaultLanguageCode, defaultCurrencyCode and isSuspended for each authorized marketplace.
- Production rollout is planned; switching to the live URL will require only a base‑URL change.
- Caching the account payload for up to 24 hours is recommended to respect rate limits and speed downstream processing.
Recommended Actions
- →Add a signed GET request to https://sandbox.sellingpartnerapi‑na.amazon.com/sellers/v1/account with required x‑amz‑access‑token and x‑amz‑date head...
- →Parse the marketplaces array and store marketplaceId, defaultLanguageCode and defaultCurrencyCode in your configuration database; cache the result ...
- →If any marketplace entry has isSuspended true, trigger an automated email alert to the seller and pause feed submissions for that region.
Comments
Join the discussion
Log in or create an account to share your thoughts on this update.
No comments yet. Be the first to share your thoughts!