GET /v1/orders/{order_id}

Summary

Fetch order status and tracking information

Description

Retrieves the current status, timeline, and tracking information for a specific order.

Request Example

curl -X GET "http://127.0.0.1:8000/api/v1/orders/ord_1234567890abcdef" \
  -H "Authorization: Bearer asap_dev_change_me"

Response Example

{
  "order_id": "ord_1234567890abcdef",
  "quote_id": "quo_1234567890abcdef",
  "status": "in_production",
  "created_at": "2026-01-23T11:00:00Z",
  "tracking": "1Z999AA10123456784",
  "timeline": [
    {"status": "accepted", "at": "2026-01-23T11:00:00Z"},
    {"status": "in_production", "at": "2026-01-23T14:30:00Z"}
  ],
  "po_number": "PO-12345",
  "contact": {"name": "John Doe", "email": "john@example.com"}
}

Error Codes

This endpoint may return the following error codes:

Code	Status	Meaning
`missing_auth`	401	No Authorization header provided
`invalid_api_key`	403	API key is invalid or missing
`order_not_found`	404	Order not found

Authentication

This endpoint requires Bearer token authentication: