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

# Poll a place in line

> Also what moves the line: admission happens when someone polls. Poll every 4 to 5 seconds while WAITING; an entry unseen for 2 minutes is dropped.



## OpenAPI

````yaml /api-reference/openapi.json get /api/checkout/queue/{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/queue/{id}:
    get:
      tags:
        - Checkout
      summary: Poll a place in line
      description: >-
        Also what moves the line: admission happens when someone polls. Poll
        every 4 to 5 seconds while WAITING; an entry unseen for 2 minutes is
        dropped.
      operationId: getQueueEntry
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
        - name: session_key
          in: query
          required: true
          schema:
            type: string
          description: The session key that owns the entry.
      responses:
        '200':
          description: Current place
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QueueEntryDto'
        '404':
          description: '`QUEUE_ENTRY_NOT_FOUND`'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDto'
components:
  schemas:
    QueueEntryDto:
      type: object
      properties:
        id:
          type: string
          description: 'The pass: send as `queue_pass` once `status` is ADMITTED.'
        event_id:
          type: string
        status:
          type: string
          enum:
            - WAITING
            - ADMITTED
            - EXPIRED
            - LEFT
        position:
          type: integer
          nullable: true
          description: >-
            1-based place in line; null while pre-queuing (drawn at opening) or
            not waiting.
        waiting_ahead:
          type: integer
          nullable: true
        estimated_minutes:
          type: integer
          nullable: true
        open:
          type: boolean
          description: Doors open (admission running)?
        opens_at:
          type: string
          format: date-time
          nullable: true
        admitted_at:
          type: string
          format: date-time
          nullable: true
        pass_expires_at:
          type: string
          format: date-time
          nullable: true
        rate:
          type: integer
          description: Admissions per minute.
    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.