@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api The Selling Partner API for Orders
@base https://sellingpartnerapi-na.amazon.com
@version 2026-01-01
@endpoints 2
@toc orders(2)

@endpoint GET /orders/2026-01-01/orders
@desc Returns orders that are created or updated during the time period that you specify. You can filter the response for specific types of orders.
@optional {createdAfter: any # The response includes orders created at or after this time. The date must be in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.  **Note**: You must provide exactly one of `createdAfter` and `lastUpdatedAfter` in your request. If `createdAfter` is provided, neither `lastUpdatedAfter` nor `lastUpdatedBefore` may be provided., createdBefore: any # The response includes orders created at or before this time. The date must be in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.  **Note**: If you include `createdAfter` in the request, `createdBefore` is optional, and if provided must be equal to or after the `createdAfter` date and at least two minutes before the time of the request. If `createdBefore` is provided, neither `lastUpdatedAfter` nor `lastUpdatedBefore` may be provided., lastUpdatedAfter: any # The response includes orders updated at or after this time. An update is defined as any change made by Amazon or by the seller, including an update to the order status. The date must be in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.  **Note**: You must provide exactly one of `createdAfter` and `lastUpdatedAfter`. If `lastUpdatedAfter` is provided, neither `createdAfter` nor `createdBefore` may be provided., lastUpdatedBefore: any # The response includes orders updated at or before this time. An update is defined as any change made by Amazon or by the seller, including an update to the order status. The date must be in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.  **Note**: If you include `lastUpdatedAfter` in the request, `lastUpdatedBefore` is optional, and if provided must be equal to or after the `lastUpdatedAfter` date and at least two minutes before the time of the request. If `lastUpdatedBefore` is provided, neither `createdAfter` nor `createdBefore` may be provided., fulfillmentStatuses: any # A list of `FulfillmentStatus` values you can use to filter the results., marketplaceIds: any # The response includes orders that were placed in marketplaces you include in this list.  Refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids) for a complete list of `marketplaceId` values., fulfilledBy: any # The response includes orders that are fulfilled by the parties that you include in this list., maxResultsPerPage: any # The maximum number of orders that can be returned per page. The value must be between 1 and 100. **Default:** 100., paginationToken: any # Pagination occurs when a request produces a response that exceeds the `maxResultsPerPage`. This means that the response is divided into individual pages. To retrieve the next page, you must pass the `nextToken` value as the `paginationToken` query parameter in the next request. You will not receive a `nextToken` value on the last page., includedData: any # A list of datasets to include in the response.}
@returns(200) Success.
@errors {400: Request has missing or invalid parameters and cannot be parsed., 403: Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature., 404: The resource specified does not exist., 413: The request size exceeded the maximum accepted size., 415: The request payload is in an unsupported format., 429: The frequency of requests was greater than allowed., 500: An unexpected condition occurred that prevented the server from fulfilling the request., 503: Temporary overloading or maintenance of the server.}

@endpoint GET /orders/2026-01-01/orders/{orderId}
@desc Returns the order that you specify.
@required {orderId: any # An Amazon-defined order identifier.}
@optional {includedData: any # A list of datasets to include in the response.}
@returns(200) Success.
@errors {400: Request has missing or invalid parameters and cannot be parsed., 403: Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature., 404: The resource specified does not exist., 413: The request size exceeded the maximum accepted size., 415: The request payload is in an unsupported format., 429: The frequency of requests was greater than allowed., 500: An unexpected condition occurred that prevented the server from fulfilling the request., 503: Temporary overloading or maintenance of the server.}

@end