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

# Retrieve Order

> Retrieves an Order object.

```http theme={null}
GET https://api.speccheckrx.com/v1/orders/:id
```

### Authentication

This endpoint requires bearer token authentication.

### Headers

<ParamField header="Authorization" type="string" required="true">
  Your bearer token in the format `Bearer <token>`.
</ParamField>

<ParamField header="User-Email" type="string" required="true">
  The email address of the user making the request.

  Must exactly match the email address used to log in to the SpecCheck Dashboard.
</ParamField>

### Parameters

<ParamField query="lab" type="string" required="true">
  The ID of the lab for this request.
</ParamField>

<ParamField query="account_number" type="string" required="true">
  The lab account number for this request.
</ParamField>

### Returns

Returns the Order object for a valid identifier. Catalog values such as frame handling, frame material, and prism direction are translated to the values used when creating the order. If a mapping no longer exists, the stored value is returned as-is.

<ResponseExample>
  ```json theme={null}
  {
    "id": "ord_1234",
    "submission_type": "new",
    "order_type": "rx",
    "lab": "lab_123",
    "lab_status": "in_progress",
    "account_number": "1234567",
    "patient": {
      "first_name": "Ada",
      "last_name": "Lovelace",
      "email": "ada@example.com",
      "phone_number": "5551234567"
    },
    "mounting_option": "Uncuts Only",
    "lens": {
      "style": "style_123",
      "material": "material_123",
      "color": "color_123",
      "coats": ["coat_123"],
      "tint": "Gray",
      "tint_instruction": "20%"
    },
    "frame": {
      "handling": "Frame to Come",
      "manufacturer": "Dior",
      "model": "DJ3553",
      "material": "Zyl",
      "color": "Gray",
      "eye_size": 51,
      "bridge": 17,
      "temple": 140,
      "a": 51.0,
      "b": 35.0,
      "lens_ed": 54.0,
      "vertex": 13.0,
      "pantoscopic_tilt": 8.0,
      "wrap": 5.0,
      "sku": "DJ3553-51"
    },
    "rx": {
      "left_eye": {
        "sphere": -2.0,
        "pd": 31.5,
        "near_pd": 29.0,
        "cylinder": -0.5,
        "axis": 180,
        "add": 2.25,
        "seg_height": 18.0,
        "oc_height": 21.0,
        "horizontal_prism": {
          "power": 3.0,
          "direction": "in"
        },
        "vertical_prism": {
          "power": 1.0,
          "direction": "up"
        }
      },
      "right_eye": {
        "sphere": -1.75,
        "pd": 31.0,
        "near_pd": 28.5,
        "cylinder": -0.25,
        "axis": 90,
        "add": 2.25,
        "seg_height": 18.0,
        "oc_height": 21.0,
        "horizontal_prism": {
          "power": 3.0,
          "direction": "in"
        }
      }
    },
    "services": ["Roll & Polish Edges"],
    "special_instructions": "Call office before shipping.",
    "shipping": {
      "name": "Ada Lovelace",
      "address": {
        "line1": "123 Main St",
        "line2": "Suite 100",
        "city": "Austin",
        "state": "TX",
        "postal_code": "78701",
        "country": "US"
      }
    },
    "created": 1710000000,
    "updated": 1710003600
  }
  ```
</ResponseExample>

<RequestExample>
  ```bash theme={null}
  curl "https://api.speccheckrx.com/v1/orders/{{ORDER_ID}}?lab={{LAB_ID}}&account_number={{ACCOUNT_NUMBER}}" \
    -H "Authorization: Bearer {{ACCESS_TOKEN}}" \
    -H "User-Email: {{USER_EMAIL}}"
  ```
</RequestExample>