---
title: "Get a single hold"
method: GET
path: "/v1/holds/{hold_id}"
tags: ["Holds"]
---

# Get a single hold

`GET /v1/holds/{hold_id}`

## Request

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

Returns existing hold by ID

## Path parameters

- `hold_id` string, required

## Response `200`

A successfully returned hold

- 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

## Other responses

- `default`: Error schema

---

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