---
title: "Get a single order"
method: GET
path: "/v2/orders/{order_id}"
tags: ["Orders v2"]
---

# Get a single order

`GET /v2/orders/{order_id}`

## Request

- Base URL: `https://api.tickettailor.com`
- URL: `https://api.tickettailor.com/v2/orders/{order_id}`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/tickettailor/apis/ticket-tailor-api/docs/v2/orders/:order_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns an order belonging to the box office, in the v2 representation.

## Path parameters

- `order_id` string, required

## Response `200`

A successfully returned order

- OrderV2: The version 2 representation of an order.
  - `object` string
  - `id` string: A unique identifier for the order
  - `buyer_details` object: Information the buyer provided in the checkout
    - `address` object: Information about the buyer's address
      - `address_1` string, nullable: First line of address
      - `address_2` string, nullable: Second line of address
      - `address_3` string, nullable: Third line of address
      - `postal_code` string, nullable: Postal code, zip code or postcode
    - `custom_questions` object[]: Buyer provided answers to custom questions in the checkout
      - `question` string
      - `answer` string, nullable
    - `email` string, nullable
    - `first_name` string, nullable
    - `last_name` string, nullable
    - `name` string, nullable
    - `phone` string, nullable
  - `created_at` string, date-time: When the order was created (ISO 8601)
  - `currency` object
    - `base_multiplier` integer: The multiplier that converts the currency's minor unit to its major unit
    - `code` string
    - `symbol` string
  - `line_items` LineItemV2[]
    - `object` string
    - `id` string
    - `booking_fee` integer: Booking fee in the currency's minor unit
    - `bundle_id` string, nullable
    - `description` string
    - `discount_id` string, nullable
    - `event_summary` object, nullable: The event occurrence this line belongs to, when it is a ticket line
      - `end_date` string, date-time
      - `event_id` string
      - `event_series_id` string
      - `name` string
      - `start_date` string, date-time
    - `fulfilment` string, nullable: The expected fulfilment type for this line
    - `fulfilments` object[]: The fulfilled units for this line (issued tickets or products)
      - `reference_id` string
      - `reference_name` string, nullable
    - `item_id` string, nullable
    - `list_booking_fee` integer
    - `list_price` integer
    - `quantity` integer
    - `store_summary` object, nullable: The store this line belongs to, when it is a product line
      - `name` string, nullable
      - `store_id` string
    - `tax` object, nullable
      - `amount` integer, nullable
      - `label` string, nullable
      - `rate` number
      - `treatment` string, nullable
    - `total` integer
    - `type` string
    - `value` integer
  - `marketing_opt_in` boolean, nullable
  - `meta_data` object[]: Arbitrary key/value metadata stored against the order
    - `key` string
    - `value` unknown
  - `notes` string, nullable
  - `referral_tag` string, nullable
  - `status` string: The order status
  - `status_message` string, nullable
  - `total` integer, nullable: The order total in the currency's minor unit (see currency.base_multiplier)
  - `transactions` object[]: The order's transaction ledger — payments taken and refunds returned
    - `transaction_id` string, nullable
    - `type` string
    - `amount` integer: Signed amount in the currency's minor unit (negative for refunds)
    - `currency` string
    - `payment_method` string
    - `pending` boolean
    - `created_at` string, date-time
  - `payment_plan` object, nullable: The order's payment plan, or null when it is not a payment plan order
    - `status` string
    - `currency` string
    - `total` integer
    - `amount_paid` integer
    - `amount_outstanding` integer
    - `instalments` object[]
      - `id` string
      - `sequence_number` integer
      - `amount` integer
      - `currency` string
      - `due_date` string, date
      - `status` string
      - `is_deposit` boolean

## Other responses

- `default`: Error schema

## Changes

- **2026-10-22** `6cb7deb21333`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tickettailor/apis/ticket-tailor-api/changes/v2/orders/:order_id/get.md)

---

[API](https://skmtc.dev/tickettailor/apis/ticket-tailor-api.md) - [All operations](https://skmtc.dev/tickettailor/apis/ticket-tailor-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tickettailor/apis/ticket-tailor-api/revisions/b10f60afda54?raw)