Update: Orders API v0 now includes the CompanyName attribute and other updates
The Orders API v0 now includes a ShippingAddress.CompanyName field (e.g., "GlobalTech Solutions") across every Amazon marketplace and raises the rate limit for getOrder, getOrderAddress and getOrderBuyerInfo to roughly 120 calls per minute, reducing throttling by about 30%.
Overview
Amazon has upgraded the Orders API v0 to include a new CompanyName attribute inside the ShippingAddress object across all marketplaces. The change, together with higher request‑rate limits for key order‑related endpoints, helps sellers capture business‑level buyer data and reduces throttling during high‑volume operations.
Key Points
- CompanyName attribute added — The ShippingAddress payload now returns the buyer’s corporate name (e.g., “Acme Manufacturing”), enabling precise invoicing for B2B orders.
- Universal rollout — The enhancement is live on every Amazon marketplace, from amazon.com to amazon.co.jp, so sellers with multi‑region catalogs see the same JSON structure everywhere.
- Increased rate limits — Amazon has raised the maximum calls per second for getOrder, getOrderAddress, and getOrderBuyerInfo, allowing more queries before a 429 response is returned.
- Backward‑compatible response — Existing integrations that ignore unknown fields continue to function because the new key is simply appended to the JSON object.
- Better data quality — Providing a dedicated company name reduces the need to parse free‑form address lines, cutting manual correction effort for corporate buyers.
- Enhanced reporting potential — Analytics tools can now pull the CompanyName field to segment sales by individual versus corporate customers, supporting more granular performance dashboards.
How the Updated Orders API v0 Works
- Request order details — A GET request to /orders/v0/orders/{orderId} now returns a ShippingAddress object that includes CompanyName. Example: Querying order 112‑334‑556 yields
"CompanyName":"GlobalTech Solutions"alongside street, city, and zip. - Retrieve address specifics — The /orders/v0/orders/{orderId}/address endpoint mirrors the enriched ShippingAddress structure. Example: A fulfillment script that previously extracted only AddressLine1 and City can now also pull CompanyName to print “GlobalTech Solutions” on the packing slip.
Analysis & Recommendations
Why This Matters
Sellers can capture the buyer’s corporate name directly for accurate B2B invoicing, eliminating the need to parse address lines. The doubled request ceiling lets bulk‑order scripts run twice as fast, cutting processing time by up to 30% and lowering 429 errors.
Key Takeaways
- CompanyName attribute added to ShippingAddress in Orders API v0, returning values like "GlobalTech Solutions".
- Rate limits for getOrder, getOrderAddress, and getOrderBuyerInfo increased to about 120 calls per minute (≈2× previous limit).
- The enhancement is rolled out universally to all Amazon marketplaces (e.g., amazon.com, amazon.co.jp).
- Responses remain backward‑compatible; existing integrations that ignore unknown fields will continue to work.
Recommended Actions
- →Update your order‑import routine to map ShippingAddress.CompanyName to your ERP’s CustomerCompany field (Seller Central > Integration > API Settings).
- →Adjust your API throttling logic to allow up to 120 calls per minute for the three endpoints (modify back‑off settings in your scheduler or Lambda ...
- →Validate the new field on at least two marketplaces by sending a sandbox GET /orders/v0/orders/{orderId} request via the SP‑API console (Developer ...
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!