Find Ticket

GET

https://api.npretail.app/:tenant/:environment/:company/ticket

GET

/:tenant/:environment/:company/ticket

curl -G https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%2520International%2520Ltd./ticket \
     -H "x-np-api-key: <NaviPartner API Key>" \
     --data-urlencode externalNumbers=TICKET123,TICKET124 \
     -d withAdmissionContent=true \
     -d withAccessHistoryDetails=true \
     -d withWallet=true \
     -d activeOnly=true

200Find tickets using external ticket numbers

[
  {
    "ticketId": "12345678-1234-1234-1234-123456789012",
    "ticketNumber": "TICKET123",
    "ticketKind": "individualAdmission",
    "reservationToken": "ABC123456DEF789GHI",
    "itemNumber": "31001",
    "validFrom": "2024-10-15T00:00:00Z",
    "validUntil": "2025-10-14T23:59:59Z",
    "issuedAt": "2024-10-15T12:13:00Z",
    "blocked": false,
    "pinCode": "12-34",
    "unitPrice": 80,
    "unitPriceInclVat": 100,
    "currencyCode": "DKK",
    "ticketHolder": "John Doe",
    "ticketHolderLanguage": "ENU",
    "notificationAddress": "john@acme.com",
    "inWallet": true,
    "wallets": [
      {
        "walletId": "a2cbd5bc-5cf4-ef11-b3a1-a1084fe21c78",
        "referenceNumber": "141234529930210327",
        "description": "My wallet holds my tickets, coupons and vouchers for the event.",
        "expiryDatetime": "2026-12-31T23:59:59Z",
        "lastPrintedAt": "2026-12-31T23:59:59Z",
        "printCount": 1,
        "originatesFromItemNo": "70009",
        "originatesFromDescription": "Family Fun Pack",
        "externalReferenceNumber": "151234529930210327"
      }
    ],
    "printCount": 1,
    "printedAt": "2024-10-15T12:00:00Z",
    "content": [
      {
        "admissionDetails": {
          "capacityControl": "sales",
          "code": "CASTLE",
          "default": true,
          "description": {
            "title": "Castle Museum Entrance",
            "subtitle": "Adult Castle Ticket",
            "name": "Explore the Castle",
            "description": "<b>Access</b> to the castle exhibit",
            "fullDescription": "<p>Experience the grandeur of the castle's architecture and marvel at its intricate details.  Walk through beautifully decorated rooms and admire the stunning artwork and furniture on display.</p>"
          },
          "included": "mandatory"
        },
        "scheduleDetails": {
          "code": "MORNING",
          "duration": 10800,
          "endDate": "2024-10-15",
          "endTime": "12:00",
          "externalNumber": 452,
          "startDate": "2024-10-15",
          "startTime": "09:00",
          "type": "initialEntry",
          "arrivalFromTime": "08:30",
          "arrivalUntilTime": "10:00",
          "description": "Morning schedule"
        }
      }
    ],
    "description": {
      "title": "Castle Museum Entrance",
      "subtitle": "Adult Castle Ticket",
      "name": "Explore History",
      "description": "<b>Access</b> to all castle exhibits",
      "fullDescription": "<p>Step back in time and immerse yourself in the rich history of our castle museum.  Discover fascinating artifacts, explore grand halls, and learn about the lives of the people who once lived within these walls.</p> <p>Experience the grandeur of the castle's architecture and marvel at its intricate details.  Walk through beautifully decorated rooms and admire the stunning artwork and furniture on display.</p> <p>Join a guided tour to gain deeper insights into the castle's history and hear captivating stories  about its past. Learn about the battles fought, the royal inhabitants, and the secrets that lie hidden within these ancient walls.</p>"
    },
    "accessHistory": [
      {
        "admissionCode": "CASTLE",
        "firstAdmissionAt": "2025-01-31T09:12:00Z",
        "events": [
          {
            "event": "admitted",
            "eventAt": "2025-01-31T09:12:00Z"
          },
          {
            "event": "departed",
            "eventAt": "2025-01-31T12:47:00Z"
          }
        ]
      }
    ]
  }
]

Retrieves ticket id and access details about a specific ticket or list of tickets, depending on which query parameter is used. If the value is not found, an empty list is returned. In case when a list of external numbers is provided, all matching tickets are returned, including duplicates. Tickets not found are omitted from the result. Leading and trailing spaces are ignored in the provided ticket numbers.
Exactly one of ticketId, externalNumbers or notificationAddress must be provided.

- Filter using ticketId, externalNumbers or notificationAddress to get a specific ticket or a list of tickets.
- Use externalNumbers to find multiple tickets by their external numbers. (Separate the ticket number with a comma).
- Admission content and item descriptions can be included with withAdmissionContent.
- Access history summary is always included; use withAccessHistoryDetails to also include event-level events.
- Use withWallet to include inWallet and wallets, the headers of the Attraction Wallets holding the ticket.
- activeOnly controls whether blocked/expired tickets are filtered out (defaults to true when omitted).

Retrieves ticket id and access details about a specific ticket or list of tickets, depending on which query parameter is used. If the value is not found, an empty list is returned. In case when a list of external numbers is provided, all matching tickets are returned, including duplicates. Tickets not found are omitted from the result. Leading and trailing spaces are ignored in the provided ticket numbers. Exactly one of `ticketId`, `externalNumbers` or `notificationAddress` must be provided. - Filter using `ticketId`, `externalNumbers` or `notificationAddress` to get a specific ticket or a list of tickets. - Use `externalNumbers` to find multiple tickets by their external numbers. (Separate the ticket number with a comma). - Admission content and item descriptions can be included with `withAdmissionContent`. - Access history summary is always included; use `withAccessHistoryDetails` to also include event-level events. - Use `withWallet` to include `inWallet` and `wallets`, the headers of the Attraction Wallets holding the ticket. - `activeOnly` controls whether blocked/expired tickets are filtered out (defaults to `true` when omitted).

Authentication

x-np-api-keystring

API Key authentication via header

Path parameters

tenantstringRequired

Your Entra Tenant ID. More details.

environmentstringRequired

Your Business Central Environment. More details.

companystringRequired

Your Business Central Company. More details.

Query parameters

externalNumbersstringOptional

A list of unique identifiers of tickets, separated by commas

ticketIdUUIDOptional

The unique identifier of a ticket

notificationAddressstringOptional

The email address or mobile phone number to send tickets and notifications to

withAdmissionContentbooleanOptional

withAccessHistoryDetailsbooleanOptional

withWalletbooleanOptional

When true, the response includes inWallet and the wallets array. Defaults to false.

activeOnlybooleanOptional

storeCodestringOptional

A unique identifier for a store - a logical grouping defining a subset of ticket items. This is used to filter the list of ticket items returned by the API. When left empty, the API will use the default store code.

Response

This endpoint returns a list of objects.

ticketIdUUID

The unique identifier of a ticket

ticketNumberstring

The unique identifier of a ticket

ticketKindenum

The kind of ticket, either individual or group admission.

reservationTokenstring

A unique token that identifies a ticket reservation

itemNumberstring

An item or product number defined in the ticketing system

validFromdatetime

validUntildatetime

issuedAtdatetime

The date and time when the ticket was issued

blockedboolean

pinCodestringOptional

A pin code for the ticket, used for validation when rescheduling or revoking a confirmed ticket

unitPricedoubleOptional

unitPriceInclVatdoubleOptional

currencyCodestringOptional

ticketHolderstringOptional

The name of the person holding the ticket(s)

ticketHolderLanguagestringOptional

The language code the ticket holder wants to receive notifications in.

notificationAddressstringOptional

The email address or mobile phone number to send tickets and notifications to

inWalletbooleanOptional

Only present when withWallet=true. true when the ticket is in a wallet.

walletslist of objectsOptional

Only present when withWallet=true. The wallets currently holding the ticket, each as Get Wallet returns it but without the assets. Empty when the ticket is in no wallet.

printCountintegerOptional

printedAtdatetimeOptional

contentlist of objectsOptional

descriptionobjectOptional

Descriptive information about a ticket item. The source of these fields are configurable.

accessHistorylist of objectsOptional

admissionEntitlementslist of objectsOptional

Authentication

Path parameters

Headers

Query parameters

Response