> ## Documentation Index
> Fetch the complete documentation index at: https://dev.phygitals.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get shipping order

> Returns the full details of a shipping order created via /api/v1/ship/request.

Returns the full details of a shipping order created via [`/api/v1/ship/request`](/api-reference/shipping/request). Use this to poll for status updates, retrieve tracking info, and reconcile billing.

## Path parameters

<ParamField path="order_id" type="string" required>
  The `order_id` returned by [`/api/v1/ship/request`](/api-reference/shipping/request).
</ParamField>

## Example request

```http theme={"dark"}
GET /api/v1/ship/order/order_123
X-API-Key: <your_api_key>
```

## Response

<ResponseExample>
  ```json 200 theme={"dark"}
  {
    "order_id": "order_123",
    "status": "shipped",
    "carrier": "USPS",
    "service": "Priority Mail",
    "tracking_number": "9400111899223344556677",
    "tracking_url": "https://tools.usps.com/go/TrackConfirmAction?tLabels=9400111899223344556677",
    "amount": 9.75,
    "currency": "USD",
    "destination": {
      "name": "Jane Doe",
      "line1": "123 Main St",
      "line2": "Apt 4B",
      "city": "Austin",
      "state": "TX",
      "postal_code": "78701",
      "country": "US"
    },
    "items": [
      {
        "item_id": "item_id_1",
        "name": "Juan Soto RC Auto /25",
        "image": "https://cdn.phygitals.com/cards/soto-rc-auto.png",
        "back_image": "https://cdn.phygitals.com/cards/soto-rc-auto-back.png"
      },
      {
        "item_id": "item_id_2",
        "name": "Mike Trout Base",
        "image": "https://cdn.phygitals.com/cards/trout-base.png",
        "back_image": null
      }
    ],
    "created_at": "2026-04-18T19:05:14.000Z",
    "shipped_at": "2026-04-19T15:30:00.000Z",
    "delivered_at": null,
    "error_message": null
  }
  ```
</ResponseExample>

<ResponseField name="order_id" type="string">
  Order identifier.
</ResponseField>

<ResponseField name="status" type="string">
  One of: `queued`, `processing`, `label_created`, `shipped`, `delivered`, `cancelled`, `failed`. In [sandbox](/enterprise-api/sandbox), the only status ever returned is `queued`. Production cycles through the full set above.
</ResponseField>

<ResponseField name="tracking_number" type="string | null">
  Carrier tracking number. `null` until a label is created.
</ResponseField>

<ResponseField name="tracking_url" type="string | null">
  Carrier tracking URL. `null` until a label is created.
</ResponseField>

<ResponseField name="amount" type="number">
  Shipping cost in USD. Billed B2B to the partner.
</ResponseField>

<ResponseField name="items" type="array">
  Items included in this shipment. Each entry includes `item_id`, `name`, `image`, and `back_image` (or `null` when not available).
</ResponseField>

<ResponseField name="shipped_at" type="string | null">
  ISO timestamp when the shipment left fulfillment. `null` until reached.
</ResponseField>

<ResponseField name="delivered_at" type="string | null">
  ISO timestamp when the shipment was delivered. `null` until reached.
</ResponseField>

<ResponseField name="error_message" type="string | null">
  Populated if `status` is `failed` or `cancelled`.
</ResponseField>

<ResponseField name="destination" type="object">
  Echoes back exactly what was submitted to [`/api/v1/ship/quote`](/api-reference/shipping/quote). [Sandbox](/enterprise-api/sandbox) does not normalize keys. If a partner submitted `zip` instead of `postal_code`, it round-trips as `zip`. Production may normalize.
</ResponseField>

## Errors

| Status | Body                                          | Cause                                                       |
| ------ | --------------------------------------------- | ----------------------------------------------------------- |
| `404`  | `{ "error": "Order not found" }`              | Unknown `order_id` or order does not belong to this partner |
| `500`  | `{ "error": "An unexpected error occurred" }` | Internal server error                                       |