---
search:
  tags:
    - Orders
    - GET
seo:
  description: >-
    Direct access to an order by ID or permalink. No shop_id needed in the URL —
    authorization… Reference for the GET /orders/{id} endpoint in the Bolder API
    v2.
sidebar:
  label: Get an order
  badge: GET
title: Get an order
type: openapi-operation
---
Direct access to an order by ID or permalink. No `shop_id` needed in the URL —
authorization is verified via the token's account ownership.

`GET /orders/{id}`

**cURL**

```bash
curl -s -H "Authorization: Bearer $BOLDER_TOKEN" \
  "https://api.onbolder.com/v2/orders/ORD-5001"
```

**Responses**

- `200` — Order entity
- `403` — Order belongs to a different account
- `404` — Order not found

Response example, 200:

```json
{
  "id": 5001,
  "shop_id": 1,
  "code": "ORD-5001",
  "status": "pending",
  "fulfillment_status": "none",
  "currency_code": "USD",
  "total": 8499,
  "total_paid": 8499,
  "created_on": "2024-06-15T09:45:00Z",
  "updated_on": "2024-06-15T09:45:00Z",
  "_embedded": {
    "contact": {
      "id": 42,
      "name": "Jane Doe",
      "email": "customer@example.com",
      "phone_number": "+15551234567"
    },
    "line_items": [
      {
        "id": 9001,
        "product_id": 101,
        "product_name": "T-Shirt",
        "variant_id": 201,
        "variant_name": "Medium / Blue",
        "units": 2,
        "unit_price": 2500,
        "net_total": 5000,
        "total": 5000
      }
    ]
  },
  "_links": {
    "self": {
      "href": "https://api.onbolder.com/v2/orders/ORD-5001"
    },
    "orders:update": {
      "href": "https://api.onbolder.com/v2/orders/ORD-5001",
      "method": "put"
    },
    "shops:show": {
      "href": "https://api.onbolder.com/v2/shops/1"
    }
  }
}
```