> ## Documentation Index
> Fetch the complete documentation index at: https://docs.underpass.com.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Read a hold



## OpenAPI

````yaml /api-reference/openapi.json get /api/checkout/holds/{id}
openapi: 3.0.0
info:
  title: UnderPass Public API
  version: 1.3.0
  description: >-
    Public API for browsing events and selling tickets on the UnderPass
    platform. Build a custom event landing or checkout on your own domain: list
    events, reserve tickets at selection, sell numbered seats, run a waiting
    room, start a checkout and poll the order. Everything added since 1.0 is
    optional and opt-in per event; a storefront built against 1.0 keeps working.
  contact:
    name: UnderPass Engineering
    email: developers@underpass.com.co
    url: https://underpass.com.co
servers:
  - url: https://api.underpass.com.co
    description: Production
  - url: https://api-dev.underpass.com.co
    description: Development
security: []
paths:
  /api/checkout/holds/{id}:
    get:
      tags:
        - Checkout
      summary: Read a hold
      operationId: getHold
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: The hold (expired if its window ran out)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HoldDto'
        '404':
          description: '`HOLD_NOT_FOUND`'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDto'
components:
  schemas:
    HoldDto:
      type: object
      properties:
        id:
          type: string
          description: Send as `hold_id` on `checkout/start`.
        event_id:
          type: string
        status:
          type: string
          enum:
            - ACTIVE
            - CONVERTED
            - CONSUMED
            - RELEASED
            - EXPIRED
        expires_at:
          type: string
          format: date-time
          description: Show a countdown; at zero the tickets are back on sale.
        order_id:
          type: string
          nullable: true
        items:
          type: array
          items:
            type: object
            properties:
              ticket_type_id:
                type: string
              selling_stage_id:
                type: string
              performance_id:
                type: string
                nullable: true
              quantity:
                type: integer
              ticket_count:
                type: integer
                description: quantity × group_size
              seat_ids:
                type: array
                items:
                  type: string
              seat_labels:
                type: array
                items:
                  type: string
    ErrorDto:
      type: object
      properties:
        statusCode:
          type: integer
        code:
          type: string
          description: Stable identifier to match on.
        message:
          type: string
        detail:
          type: object
          additionalProperties: true
        timestamp:
          type: string
          format: date-time

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.