Orders V2026_01_01#

class sp_api.api.OrdersV20260101(marketplace: ~sp_api.base.marketplaces.Marketplaces = Marketplaces.US, *, refresh_token=None, account='default', credentials=None, restricted_data_token=None, proxies=None, verify=True, timeout=None, version=None, credential_providers=None, auth_token_client_class=<class 'sp_api.auth.access_token_client.AccessTokenClient'>)#

Orders API (version 2026-01-01).

This is a newer Orders API version that uses different endpoints/parameters than the legacy v0 Orders API implemented by sp_api.api.orders.orders.Orders.

Model source: amzn/selling-partner-api-models

search_orders(self, **kwargs) → ApiResponse#

Returns orders that are created or updated during the time period that you specify. You can filter the response for specific types of orders.

Usage Plan:

Rate (requests per second)

Burst

See x-amzn-ratelimit-limit response

See Amazon docs

Note

The SP-API returns an x-amzn-ratelimit-limit (or similar) response header indicating the rate limit applied to the request. Rate and burst can vary by seller/account and by any Amazon-granted overrides.

For more information, see “Usage Plans and Rate Limits” in the Selling Partner API documentation.

Examples

literal blocks:

OrdersV20260101().search_orders(
    createdAfter="2026-01-01T00:00:00Z",
    marketplaceIds=["A1PA6795UKMFR9"]
)
Parameters:

  • createdAfter (key) – str

  • createdBefore (key) – str

  • lastUpdatedAfter (key) – str

  • lastUpdatedBefore (key) – str

  • fulfillmentStatuses (key) – [str] | str

  • marketplaceIds (key) – [str] | str

  • fulfilledBy (key) – [str] | str

  • includedData (key) – [str] | str

  • paginationToken (key) – str

  • maxResultsPerPage (key) – int

Return type:

ApiResponse

get_order(self, order_id: str, **kwargs) → ApiResponse#

Returns the order that you specify.

Usage Plan:

Rate (requests per second)

Burst

See x-amzn-ratelimit-limit response

See Amazon docs

Note

The SP-API returns an x-amzn-ratelimit-limit (or similar) response header indicating the rate limit applied to the request. Rate and burst can vary by seller/account and by any Amazon-granted overrides.

For more information, see “Usage Plans and Rate Limits” in the Selling Partner API documentation.

Examples

literal blocks:

OrdersV20260101().get_order(
    "306-9860906-6213927",
    includedData=["orderItems"]
)
Parameters:

  • order_id – str

  • includedData (key) – [str] | str

Return type:

ApiResponse