Skip to main content
GET
/
orders
/
{order_id}
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "pending",
  "max_price": 123,
  "items": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "url": "<string>",
      "quantity": 123,
      "status": "pending",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "shipping_address": {},
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}
Retrieve detailed information about a specific order using its unique identifier.

Path Parameters

  • order_id (required) - The UUID of the order to retrieve

Response

Returns a complete order object with:
  • id - Order UUID
  • status - Current order status
  • items - Array of order items with individual statuses
  • shipping_address - Delivery address
  • job_result - Detailed processing results (when available)
  • created_at - Order creation timestamp
  • updated_at - Last update timestamp

Item-Level Status

Each item in the order has its own status tracking:
{
  "id": "item-uuid",
  "url": "https://www.amazon.com/...",
  "quantity": 2,
  "status": "shipped",
  "created_at": "2025-11-24T10:00:00Z",
  "updated_at": "2025-11-24T12:30:00Z"
}

Job Results

For completed or failed orders, the job_result field contains detailed information about the order processing, including:
  • Success/failure status
  • Retailer confirmation numbers
  • Tracking information
  • Error details (if failed)
Poll this endpoint to track order progress. We recommend checking every 30-60 seconds while the order is processing.

Error Responses

  • 404 Not Found - Order ID does not exist or you don’t have access to it
  • 401 Unauthorized - Invalid or missing authentication

Headers

authorization
string | null

Path Parameters

order_id
string<uuid>
required

Response

Successful Response

Response model for order data.

id
string<uuid>
required
status
enum<string>
required
Available options:
pending,
in_progress,
order_placed,
order_failed
max_price
integer
required
items
OrderItemResponse · object[]
required
shipping_address
Shipping Address · object
required
created_at
string<date-time>
required
updated_at
string<date-time>
required