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

# Get a single order

`GET /v1/orders/{order_id}`

Returns an order belonging to the box office

## Path parameters

- `order_id` string, required

## Response `200`

A successfully returned order

- Order
  - `object` string, required
  - `id` string, required — A unique identifier for the order
  - `buyer_details` object, required — Information buyer provided in the checkout
    - `address` object, required — Information about buyer address
      - `address_1` string, nullable, required — First line of address
      - `address_2` string, nullable, required — Second line of address
      - `address_3` string, nullable, required — Third line of address
      - `postal_code` string, nullable, required — Postal code, zip code or postcode
    - `custom_questions` object[] — Buyer provided answers to custom questions in checkout
      - `question` string
      - `answer` string, nullable
    - `email` string, required — Buyer email address
    - `first_name` string, required — Buyer first name
    - `last_name` string, required — Buyer last name
    - `name` string, required — Buyer full name
    - `phone` string, nullable, required — Buyer phone number
  - `created_at` integer, required — Order creation timestamp
  - `currency` object, required — Information about order currency
    - `code` 'gbp' | 'usd' | 'eur' | 'sgd' | 'aud' | 'brl' | 'cad' | 'czk' | 'dkk' | 'hkd' | 'huf' | 'ils' | 'jpy' | 'myr' | 'mxn' | 'nok' | 'nzd' | 'php' | 'pln' | 'rub' | 'sek' | 'chf' | 'twd' | 'thb' | 'try', required — Currency used for purchase
    - `base_multiplier` integer, required — Base multiplier for conversions
  - `event_summary` object — Short event summary this order was made for
    - `id` string — ID of the event occurrence an order belongs to (deprecated)
    - `event_id` string — ID of the event occurrence an order belongs to
    - `event_series_id` string — ID of the event series an order belongs to
    - `name` string — Name of the event
    - `start_date` object — The start date for the event in various formats
      - `date` string, required — ISO-8601 date for the start of the event
      - `formatted` string, required — A formatted date string for the start of the event
      - `iso` string, required — ISO-8601 date and time for the start of the event
      - `time` string, required — Time for the start of the event
      - `timezone` string, required — Timezone offset for the start of the event
      - `unix` integer, required — Unix timestamp for the start of the event
    - `end_date` object — The end date for the event in various formats
      - `date` string, required — ISO-8601 date for the end of the event
      - `formatted` string, required — A formatted date string for the end of the event
      - `iso` string, required — ISO-8601 date and time for the end of the event
      - `time` string, required — Time for the end of the event
      - `timezone` string, required — Timezone offset for the end of the event
      - `unix` integer, required — Unix timestamp for the end of the event
    - `venue` object — The venue information for the event
      - `country` string, nullable — Country of the venue
      - `name` string, nullable, required — The name of the venue
      - `postal_code` string, nullable, required — The postcode of the venue for this event
  - `issued_tickets` IssuedTicket[], nullable, required — Issued tickets for order
    - `object` string, required
    - `id` string, required — A unique identifier for the issued ticket
    - `add_on_id` string, nullable — A unique identifier for the associated product
    - `barcode` string, required — Barcode text value
    - `barcode_url` string, required — URL to barcode image
    - `checked_in` string, required — Returns whether or not issued ticket is checked in
    - `created_at` integer, required — Timestamp when issued ticket was created
    - `custom_questions` object[], required — Buyer provided answers to custom questions in checkout
      - `question` string
      - `answer` string, nullable
    - `description` string, required
    - `email` string, nullable, required — The order email address
    - `event_id` string, required — ID of the event issued ticket belongs to
    - `event_series_id` string, required — ID of the event series the issued ticket belongs to
    - `group_ticket_barcode` string, nullable, required — Barcode for group ticket, if it is part of one
    - `reference` string, nullable, required — An external reference for imported tickets (via the API or Dashboard)
    - `full_name` string, nullable, required — Full name of attendee
    - `first_name` string, nullable, required — First name of attendee
    - `last_name` string, nullable, required — Last name of attendee
    - `listed_currency` object, nullable — List currency of the ticket type at the time of purchase
      - `base_multiplier` integer
      - `code` 'gbp' | 'usd' | 'eur' | 'sgd' | 'aud' | 'brl' | 'cad' | 'czk' | 'dkk' | 'hkd' | 'huf' | 'ils' | 'jpy' | 'myr' | 'mxn' | 'nok' | 'nzd' | 'php' | 'pln' | 'rub' | 'sek' | 'chf' | 'twd' | 'thb' | 'try'
    - `listed_price` integer, nullable — List price of the ticket type at the time of purchase
    - `reservation` string, nullable, required — Reservation from seating chart where applicable
    - `status` 'valid' | 'voided', required
    - `source` 'api' | 'dashboard_import', nullable, required
    - `ticket_type_id` string, nullable, required — ID of the ticket type
    - `updated_at` integer, required — Timestamp when issued ticket was last updated
    - `voided_at` integer, nullable, required — Timestamp when issued ticket was voided
    - `order_id` string, nullable, required — A unique identifier for the order
    - `qr_code_url` string, required — URL to QR code image
  - `sold_products` SoldProduct[], nullable, required — Sold products for order
    - `object` string, required
    - `id` string, required — A unique identifier for the sold product
    - `event_id` string, nullable, required — ID of the event if sold through event sales channel
    - `fulfilment` 'none' | 'issued_ticket' | 'issued_membership' | 'issued_voucher', required — Type of fulfilment for this product
    - `fulfilment_reference_id` string, nullable, required — Prefixed ID of the issued ticket (it_), membership (im_), or voucher (vo_) if fulfilled
    - `fulfilment_reference_name` string, nullable, required — Name/label of the fulfilment reference
    - `order_id` string, required — A unique identifier for the order
    - `product_id` string, required — A unique identifier for the product
    - `product_name` string, required — Name of the product
    - `sales_channel` 'event' | 'store', required — Where the product was sold (event or store)
    - `sales_channel_reference_name` string, required — Display name of the event or store
    - `status` 'valid' | 'voided', required — Status of the sold product
    - `store_id` integer, nullable, required — ID of the store if sold through store sales channel
  - `line_items` object[], required
    - `object` string, required
    - `id` string, required — A unique identifier for the basket item
    - `booking_fee` integer, required — Optional booking fee which is charged per ticket type to the customer and the funds are paid to you.
    - `description` string, required — Basket item description
    - `item_id` string, nullable — The line item type id with a prefix.
    - `quantity` integer, required — Amount of line item objects
    - `store_id` string, nullable — The store id prefixed with 'st_'
    - `total` integer, required — Total amount including tax for line item
    - `type` 'ticket' | 'transaction_charge' | 'void' | 'tax' | 'gift_card' | 'donation', required — `ticket` is a purchased ticket, `transaction_charge` is a transaction fee to orders. This is charged once per order as opposed to ticket booking fees which are charged once per ticket. `void` means ticket was voided after the purchase, `tax` is sales tax eg. VAT, `gift_card` is discount or voucher applied and `donation` is for donating value
    - `value` integer, required — Amount without tax
  - `marketing_opt_in` string, nullable — Whether the buyer opted in to receive marketing emails
  - `meta_data` object[] — Meta data attached to the order
    - `key` string
    - `value` string, nullable
  - `notes` string, nullable — Notes attached to the order
  - `payment_method` PaymentMethod, required
    - `external_id` string, nullable, required — A unique identifier for the payment method
    - `id` string, nullable, required — A unique identifier for internal payment methods
    - `type` 'no_cost' | 'offline' | 'operator' | 'paypal' | 'stripe' | 'transfer', required — The type of payment method
    - `name` string, nullable, required — Name of the payment method
    - `instructions` string, nullable, required — Instructions for the customer on how to pay. Used for offline payments.
    - `additional_stripe_payment_methods` string[], required — Additional Stripe payment methods enabled on this method, e.g. ideal, klarna. Empty for non-Stripe types.
    - `paypal_pay_later_enabled` string, required — Whether PayPal Buy Now Pay Later is enabled on this method. Always false for non-PayPal types.
    - `min_order_value` number, float, nullable, required — Minimum order total required to use this payment method. Used for offline methods.
    - `max_order_value` number, float, nullable, required — Maximum order total allowed for this payment method. Used for offline methods.
    - `lead_time_before_event` integer, nullable, required — Minimum number of days before the event start that an order using this payment method must be placed. Used for offline methods.
  - `refund_amount` integer, required — Refunded amount in cents
  - `refunded_voucher_id` integer, nullable, required — The unique identifier for the existing voucher
  - `credited_out_amount` integer — Refunded amount issued as credit in cents
  - `referral_tag` string, nullable, required — A unique tag to track where sales originated
  - `status` 'completed' | 'pending' | 'cancelled', required — Possible states of the order
  - `status_message` string, nullable, required — Message associated with status.
  - `subtotal` integer, required — Sum without tax
  - `tax` integer, required — Tax sum
  - `tax_treatment` 'exclusive' | 'inclusive' — How tax was calculated
  - `total` integer, required — Total value of order
  - `total_paid` integer, required — Total amount paid for this order including tax
  - `txn_id` string, nullable, required — A unique identifier for the transaction

## Other responses

- `default` — Error schema

---

[API](https://skmtc.net/tickettailor/apis/ticket-tailor-api.md) · [All operations](https://skmtc.net/tickettailor/apis/ticket-tailor-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tickettailor/ticket-tailor-api/revisions/7b222e8ec91c/schema)