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

# Get Event

> Retrieve a single event with its ticket types. If the event has exactly one timeslot, it is included as `timeslot`. Requires the `events.read` scope.



## OpenAPI

````yaml get /events/{id}
openapi: 3.0.0
info:
  version: 1.0.0
  title: Tickable API
  description: >-
    The Tickable API provides programmatic access to events, orders, tickets,
    and webhooks for your organization.
  contact:
    name: Tickable
    url: https://tickable.nl
servers:
  - url: https://api.tickable.io
    description: Production
security:
  - Bearer: []
tags:
  - name: Events
    description: Manage events
  - name: Tickets
    description: View tickets
  - name: Orders
    description: View orders
  - name: Webhooks
    description: Manage webhook subscriptions
  - name: User
    description: Current user information
  - name: OAuth
    description: OAuth2 authorization and token endpoints
paths:
  /events/{id}:
    get:
      tags:
        - Events
      summary: Get event
      description: >-
        Retrieve a single event with its ticket types. If the event has exactly
        one timeslot, it is included as `timeslot`. Requires the `events.read`
        scope.
      operationId: getEvent
      parameters:
        - schema:
            type: string
            format: uuid
            description: Event ID
            example: 550e8400-e29b-41d4-a716-446655440000
          required: true
          description: Event ID
          name: id
          in: path
      responses:
        '200':
          description: Event found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Event'
        '404':
          description: Event not found
      security:
        - Bearer: []
components:
  schemas:
    Event:
      type: object
      properties:
        id:
          type: string
          format: uuid
          example: 550e8400-e29b-41d4-a716-446655440000
        title:
          type: string
          example: Summer Festival 2026
        description:
          type: string
          nullable: true
          example: Annual summer music festival
        slug:
          type: string
          nullable: true
          example: summer-festival-2026
        location:
          type: string
          nullable: true
          example: Vondelpark
        address:
          type: string
          nullable: true
          example: Vondelpark 1, Amsterdam
        website:
          type: string
          nullable: true
          example: https://summerfestival.nl
        image_url:
          type: string
          nullable: true
          example: https://cdn.tickable.nl/events/header.jpg
        is_public:
          type: boolean
          example: true
        sales_starts_at:
          type: string
          nullable: true
          example: '2026-05-01T00:00:00Z'
        created_at:
          type: string
          example: '2026-04-01T12:00:00Z'
        ticket_types:
          type: array
          items:
            $ref: '#/components/schemas/TicketType'
        timeslot:
          $ref: '#/components/schemas/Timeslot'
      required:
        - id
        - title
        - description
        - slug
        - location
        - address
        - website
        - image_url
        - is_public
        - sales_starts_at
        - created_at
        - ticket_types
        - timeslot
    TicketType:
      type: object
      properties:
        id:
          type: string
          format: uuid
          example: b2c4e6a8-1234-4f5a-9c8d-0e1f2a3b4c5d
        name:
          type: string
          example: Early Bird
        description:
          type: string
          example: Limited early bird tickets
        price:
          type: number
          example: 25
        min_per_order:
          type: number
          nullable: true
          example: 1
        max_per_order:
          type: number
          nullable: true
          example: 10
        total_available:
          type: number
          nullable: true
          example: 500
        visibility:
          type: string
          enum:
            - visible
            - hidden
          example: visible
      required:
        - id
        - name
        - description
        - price
        - min_per_order
        - max_per_order
        - total_available
        - visibility
    Timeslot:
      type: object
      nullable: true
      properties:
        id:
          type: string
          format: uuid
          example: d4e5f6a7-8901-4b2c-3d4e-5f6a7b8c9d0e
        title:
          type: string
          nullable: true
          example: Morning Session
        starts_at:
          type: string
          example: '2026-06-15T10:00:00Z'
        ends_at:
          type: string
          nullable: true
          example: '2026-06-15T12:00:00Z'
        total_available:
          type: number
          nullable: true
          example: 200
        ticket_type_ids:
          type: array
          nullable: true
          items:
            type: string
            format: uuid
          example:
            - b2c4e6a8-1234-4f5a-9c8d-0e1f2a3b4c5d
      required:
        - id
        - title
        - starts_at
        - ends_at
        - total_available
        - ticket_type_ids
      description: Included when the event has exactly one timeslot
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
      description: >-
        Pass as `Authorization: Bearer {token}`. Accepts either an OAuth2 JWT
        access token or an API key (`tk_live_...`) created from the Tickable
        dashboard.

````