---
search:
  tags:
    - Orders
    - GET
seo:
  description: >-
    Get a single order by reference for the authenticated user… Reference for
    the GET /api/v1/{app_id}/orders/reference/{reference} endpoint in the
    Customers API.
sidebar:
  label: Get order by reference for authenticated user
  badge: GET
title: Get order by reference for authenticated user
type: openapi-operation
---
Get a single order by reference for the authenticated user with full product and variant data

`GET /api/v1/{app_id}/orders/reference/{reference}`

**Responses**

- `200` — OK
- `400` — Invalid request
- `401` — Unauthorized
- `404` — Order not found
- `500` — Internal server error

Response example, 200:

```json
{
  "app_id": "string",
  "billing_address": "string",
  "bonus_total": 0,
  "country_code": "string",
  "created_at": "string",
  "currency_code": "string",
  "discount_total": 0,
  "gift_card_total": 0,
  "grand_total": 0,
  "id": "string",
  "language_code": "string",
  "lines": [
    {
      "base_price_amount": 0,
      "created_at": "string",
      "currency_code": "string",
      "id": "string",
      "order_id": "string",
      "product": {
        "brand": {
          "id": "string",
          "name": "string",
          "slug": "string",
          "variant": "string"
        },
        "created_at": "string",
        "custom": {
          "property1": null,
          "property2": null
        },
        "description": "string",
        "html_description": "string",
        "html_short_description": "string",
        "id": "string",
        "images": [
          {
            "alt_text": "string",
            "blurhash": "string",
            "custom": {
              "property1": null,
              "property2": null
            },
            "id": "string",
            "image_url": "string",
            "title": "string"
          }
        ],
        "product_name": "string",
        "product_number": "string",
        "short_description": "string",
        "slug": "string",
        "status": "string",
        "translations_description": {
          "property1": null,
          "property2": null
        },
        "translations_html_description": {
          "property1": null,
          "property2": null
        },
        "translations_html_short_description": {
          "property1": null,
          "property2": null
        },
        "translations_product_name": {
          "property1": null,
          "property2": null
        },
        "translations_short_description": {
          "property1": null,
          "property2": null
        },
        "translations_slug": {
          "property1": null,
          "property2": null
        },
        "updated_at": "string",
        "variants": [
          {
            "created_at": "string",
            "id": "string",
            "images": [
              {
                "alt_text": "string",
                "blurhash": "string",
                "custom": {
                  "property1": null,
                  "property2": null
                },
                "id": "string",
                "image_url": "string",
                "title": "string"
              }
            ],
            "prices": [
              {
                "amount_cents_with_tax": 0,
                "country_codes": [
                  "string"
                ],
                "created_at": "string",
                "id": "string",
                "market_id": "string",
                "market_slug": "string",
                "on_sale": true,
                "reference_price": 0,
                "sale_end_date": "string",
                "sale_price_with_tax": 0,
                "sale_start_date": "string",
                "status": "string",
                "store_group": "string",
                "store_group_slug": "string",
                "updated_at": "string",
                "variant_id": "string"
              }
            ],
            "product_id": "string",
            "status": "string",
            "translations_name": {
              "property1": null,
              "property2": null
            },
            "updated_at": "string",
            "validate_stock": true,
            "variant_name": "string",
            "variant_number": "string"
          }
        ]
      },
      "product_id": "string",
      "quantity": 0,
      "tax_group_id": "string",
      "total_discount_amount": 0,
      "total_price_amount": 0,
      "total_sale_price": 0,
      "total_tax_amount": 0,
      "updated_at": "string",
      "variant": {
        "created_at": "string",
        "id": "string",
        "images": [
          {
            "alt_text": "string",
            "blurhash": "string",
            "custom": {
              "property1": null,
              "property2": null
            },
            "id": "string",
            "image_url": "string",
            "title": "string"
          }
        ],
        "prices": [
          {
            "amount_cents_with_tax": 0,
            "country_codes": [
              "string"
            ],
            "created_at": "string",
            "id": "string",
            "market_id": "string",
            "market_slug": "string",
            "on_sale": true,
            "reference_price": 0,
            "sale_end_date": "string",
            "sale_price_with_tax": 0,
            "sale_start_date": "string",
            "status": "string",
            "store_group": "string",
            "store_group_slug": "string",
            "updated_at": "string",
            "variant_id": "string"
          }
        ],
        "product_id": "string",
        "status": "string",
        "translations_name": {
          "property1": null,
          "property2": null
        },
        "updated_at": "string",
        "validate_stock": true,
        "variant_name": "string",
        "variant_number": "string"
      },
      "variant_id": "string"
    }
  ],
  "merchant_user_id": "string",
  "payment_method": "string",
  "payment_method_id": "string",
  "payment_method_name": "string",
  "reference": "string",
  "session_id": "string",
  "shipping_address": "string",
  "shipping_methods": [
    "string"
  ],
  "shipping_total": 0,
  "source": "string",
  "status": "string",
  "sub_total": 0,
  "tax_total": 0,
  "updated_at": "string"
}
```