Find Ticket | NaviPartner | NP Retail API Documentation

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 activeOnly=true

[
  {
    "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",
    "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.
- 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. - `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

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.

Allowed values:

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

pinCodestring

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

unitPricedouble

unitPriceInclVatdouble

currencyCodestring

ticketHolderstring

The name of the person holding the ticket(s)

ticketHolderLanguagestring

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

notificationAddressstring

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

printCountinteger

printedAtdatetime

contentlist of objects

descriptionobject

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

accessHistorylist of objects

admissionEntitlementslist of objects

Authentication

Path parameters

Headers

Query parameters

Response