---
title: "Get Reservation"
method: GET
path: "/{tenant}/{environment}/{company}/ticket/reservation/{token}"
tags: ["ticketing > Reservations"]
---

# Get Reservation

`GET /{tenant}/{environment}/{company}/ticket/reservation/{token}`

Retrieves the current details of an existing reservation using its token. This endpoint allows clients to check the status, contents, and expiration time of a reservation, whether it's registered or confirmed.

## Path parameters

- `tenant` string, required — Your Entra Tenant ID. [More details.](/paths#1-tenant)
- `environment` string, required — Your Business Central Environment. [More details.](/paths#2-environment)
- `company` string, required — Your Business Central Company. [More details.](/paths#3-company)
- `token` string, required — A unique token that identifies a ticket reservation

## Query parameters

- `includeTicketNumbers` boolean — Indicates whether ticket numbers should be included in reservation responses. Tickets are normally included only when the reservation is confirmed. If `true`, ticket numbers are returned regardless of reservation status. When a reservation is updated, any previously disclosed ticket numbers are removed.

## Headers

- `x-api-version` string, date — Used for API versioning. [More details.](/apis/versioning)

## Response `200`

Response with status 200

- TicketingServiceReservationsGetReservationDetails — Returned in response to reservation-related operations to provide the current state of the reservation. Includes the token identifying the reservation, its expiresAt timestamp, reservationStatus, and a list of reserved items (reservations) with their details.
  - `token` string, required — A unique token that identifies a ticket reservation
  - `expiresAt` string, date-time — The date and time when the token expires and reservation is no longer valid
  - `reservationStatus` 'registered' | 'confirmed' | 'alreadyConfirmed' | 'canceled' | 'expired' | 'reserved' | 'optional', required
  - `reservations` TicketingServiceReservationsReservationItemDetails[]
    - `itemNumber` string, required — An item or product number defined in the ticketing system
    - `quantity` integer, required — The number of tickets to reserved
    - `lineId` string, uuid, required — Stable identifier for this reservation line. Store and echo it back when reconciling sales documents or tickets with the originating reservation.
    - `ticket` TicketingServiceReservationsReservationTicketDetails, required — Offers detailed ticket information within a reservation, including ticketNumbers if confirmed, validity periods (validFrom, validUntil), pricing details, and optional customer information like pinCode and ticketHolder name. Used to inform customers about their tickets and any actions they can perform.
      - `ticketKind` 'individualAdmission' | 'groupAdmission', required
      - `ticketNumbers` TicketingTypesCompositeTicketNumbers[]
        - `ticketId` string, uuid, required — The unique identifier of a ticket
        - `ticketNumber` string, required — The unique identifier of a ticket
      - `validFrom` string, date-time, required
      - `validUntil` string, date-time, required
      - `issuedAt` string, date-time, required — The date and time when the ticket was issued
      - `blocked` boolean, required
      - `pinCode` string — A pin code for the ticket, used for validation when rescheduling or revoking a confirmed ticket
      - `unitPrice` number, double, required
      - `unitPriceInclVat` number, double, required
      - `currencyCode` string, required
      - `ticketHolder` string — The name of the person holding the ticket(s)
      - `admissionEntitlements` TicketingTypesCompositeAdmissionEntitlement[]
        - `code` string, required — A unique code that identifies a specific admission.
        - `maxGroupSize` integer, required — The maximum group size for a group ticket. Calculated as ordered quantity multiplied by a factor defined per admission.
    - `content` TicketingServiceReservationsTicketContentDetails[], required
      - `admissionDetails` TicketingTypesCompositeAdmissionDetails, required — Details of the admission for a specific reservation
        - `code` string, required — A unique code that identifies a specific admission.
        - `description` TicketingTypesCompositeDescriptions, required — Descriptive information about a ticket item. The source of these fields are configurable.
          - `title` string
          - `subtitle` string
          - `name` string
          - `description` string
          - `fullDescription` string
        - `default` boolean, required — Indicates if this admission is the default admission when there are multiple admission defined.
        - `included` 'mandatory' | 'optionalNotSelected' | 'optionalAndSelected', required
        - `capacityControl` 'none' | 'sales' | 'admitted' | 'full', required
        - `scheduleDetails` TicketingTypesCompositeScheduleDetails — Details of the schedule for a specific reservation or ticket.
          - `externalNumber` integer, required — The ID of a specific time slot for a specific admission
          - `code` string, required
          - `description` string
          - `startDate` string, date, required
          - `startTime` string, required
          - `endDate` string, date, required
          - `endTime` string, required
          - `duration` integer, required
          - `arrivalFromTime` string — The earliest time a customer can arrive for the time slot.
          - `arrivalUntilTime` string — The latest time a customer can arrive for the time slot.
          - `type` 'initialEntry' | 'reservation' | 'admitted' | 'departed' | 'consumed' | 'canceledAdmission' | 'payment' | 'prePaid' | 'postPaid' | 'canceledReservation' | 'requested' | 'unknown'
      - `scheduleDetails` TicketingTypesCompositeScheduleDetails, required — Details of the schedule for a specific reservation or ticket.
        - `externalNumber` integer, required — The ID of a specific time slot for a specific admission
        - `code` string, required
        - `description` string
        - `startDate` string, date, required
        - `startTime` string, required
        - `endDate` string, date, required
        - `endTime` string, required
        - `duration` integer, required
        - `arrivalFromTime` string — The earliest time a customer can arrive for the time slot.
        - `arrivalUntilTime` string — The latest time a customer can arrive for the time slot.
        - `type` 'initialEntry' | 'reservation' | 'admitted' | 'departed' | 'consumed' | 'canceledAdmission' | 'payment' | 'prePaid' | 'postPaid' | 'canceledReservation' | 'requested' | 'unknown'

## Changes

- **2026-09-17** `48cacf22ffcd` — 2 breaking, 1 warning, 6 info
  - for the `query` request parameter `includeTicketNumbers`, the type changed from no type to `boolean`
  - the response's body type changed from no type to `object` for status `200`
  - deleted the `header` request parameter `x-np-api-key`
  - the endpoint scheme security `NPApiKeyAuthScheme` was added to the API
  - …5 more
- **2026-09-12** `407697660280` — 1 info
  - api operation id `get-reservation` removed and replaced with `ticketing_serviceReservations_getReservation`

[Change history](https://skmtc.dev/navipartner/apis/api-reference/changes/:tenant/:environment/:company/ticket/reservation/:token/get.md)

---

[API](https://skmtc.dev/navipartner/apis/api-reference.md) · [All operations](https://skmtc.dev/navipartner/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc.dev/navipartner/apis/api-reference/revisions/48cacf22ffcd?raw)