---
title: "List holds"
method: GET
path: "/v1/holds"
tags: ["Holds"]
---

# List holds

`GET /v1/holds`

Returns a paginated list of holds

## Query parameters

- `limit` string
- `event_id` string
- `created_at` integer
- `created_at.gt` integer
- `created_at.gte` integer
- `created_at.lt` integer
- `created_at.lte` integer
- `updated_at` integer
- `updated_at.gt` integer
- `updated_at.gte` integer
- `updated_at.lt` integer
- `updated_at.lte` integer

## Response `200`

A successfully returned list of holds

- object
  - `data` Hold[]
    - `object` string
    - `id` string — A unque identifier for the hold
    - `created_at` object
      - `date` string — ISO-8601 date for the created timestamp of the hold
      - `formatted` string — A formatted date string for the created timestamp of the hold
      - `iso` string — ISO-8601 date and time for the created timestamp of the hold
      - `time` string — Time of the created timestamp of the hold
      - `timezone` string — Timezone offset for the created timestamp of the hold
      - `unix` integer — Unix timestamp for when the hold was created
    - `event_id` string — ID of the event that the hold belongs to
    - `note` string — A note for the hold
    - `total_on_hold` integer — Total number of tickets on hold
    - `updated_at` object
      - `date` string — ISO-8601 date for the updated timestamp of the hold
      - `formatted` string — A formatted date string for the updated timestamp of the hold
      - `iso` string — ISO-8601 date and time for the updated timestamp of the hold
      - `time` string — Time of the updated timestamp of the hold
      - `timezone` string — Timezone offset for the updated timestamp of the hold
      - `unix` integer — Unix timestamp for when the hold was updated
    - `quantities` object[] — Hold quantities for each of the associated ticket type ID
      - `ticket_type_id` string — Ticket type ID
      - `quantity` integer — Number of held tickets of this type
  - `links` object
    - `next` string, nullable
    - `previous` string, nullable

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