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

# Get Order

> Retrieve order status and tracking

## Endpoint

```http theme={null}
GET /v1/orders/{order_id_or_number}
```

## Request

```bash theme={null}
curl https://api.sp3ndpay.shop/v1/orders/SP3ND-184920 \
  -H "Authorization: Bearer sp3ndpay_live_xxx"
```

## Response

```json theme={null}
{
  "order": {
    "id": "ord_8nJ42rA",
    "number": "SP3ND-184920",
    "status": "shipped",
    "total": 109.27,
    "payment_status": "confirmed",
    "created_at": "2026-05-04T18:30:00Z",
    "tracking": {
      "current_step": "shipped",
      "carrier": "USPS",
      "tracking_number": "9400111899562843567890",
      "estimated_delivery": "2026-05-08",
      "steps": [
        {"name": "created", "completed": true, "timestamp": "2026-05-04T18:30:00Z"},
        {"name": "paid", "completed": true, "timestamp": "2026-05-04T18:35:00Z"},
        {"name": "ordered", "completed": true, "timestamp": "2026-05-04T19:15:00Z"},
        {"name": "shipped", "completed": true, "timestamp": "2026-05-05T14:20:00Z"},
        {"name": "delivered", "completed": false, "timestamp": null}
      ]
    }
  }
}
```

## Order Status

| Status      | Description         |
| ----------- | ------------------- |
| `created`   | Waiting for payment |
| `paid`      | Payment confirmed   |
| `ordered`   | Product sourced     |
| `shipped`   | In transit          |
| `delivered` | Arrived             |

## Polling

Poll every 30-60 seconds for updates. Stop when status is `delivered`, `cancelled`, or `failed`.

## Errors

**Order Not Found:**

```json theme={null}
{
  "error": {
    "code": "order_not_found",
    "message": "No order with specified ID"
  }
}
```

<Card title="Error Reference" icon="triangle-exclamation" href="/api-reference/errors">
  View all error codes
</Card>