---
title: "List orders"
method: GET
path: "/v2/orders"
tags: ["Orders v2"]
---

# List orders

`GET /v2/orders`

## Request

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

Returns a list of orders belonging to the box office, in the v2 representation.

## Query parameters

- `created_at` integer
- `created_at.gt` integer
- `created_at.gte` integer
- `created_at.lt` integer
- `created_at.lte` integer
- `starting_after` string
- `ending_before` string
- `limit` string
- `name` string
- `email` string
- `txn_id` string
- `barcode` string
- `event_id` string
- `event_series_id` string
- `status` 'completed' | 'pending' | 'cancelled'
- `store_id` string
- `referral_tag` string

## Response `200`

A successfully returned list of orders

- object
  - `data` OrderV2[]
    - `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
  - `links` object
    - `next` string, nullable
    - `previous` string, nullable

## 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/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)