Get Ticket

GET

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

GET

/:tenant/:environment/:company/ticket/:ticketId

curl -G https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%2520International%2520Ltd./ticket/12345678-1234-1234-1234-123456789012 \
     -H "x-np-api-key: <NaviPartner API Key>" \
     -d storeCode=EN \
     -d withAccessHistory=true \
     -d withAccessHistoryDetails=true \
     -d withWallet=true

200Get individual admission ticket

{
  "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,
  "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>"
  },
  "pinCode": "1234-5678",
  "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",
  "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 detailed information about a specific ticket using its unique ticketId. Admission content and descriptions are always included. Use withAccessHistory to include summarized access history and withAccessHistoryDetails to additionally include event-level access history. Use withWallet to include inWallet and wallets, the headers of the Attraction Wallets holding the ticket.

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.

ticketIdUUIDRequired

The unique identifier of a ticket

Query parameters

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.

withAccessHistorybooleanOptional

withAccessHistoryDetailsbooleanOptional

withWalletbooleanOptional

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

Response

This endpoint returns an object.

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

contentlist of objects

descriptionobject

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

pinCodestringOptional

A pin code for the ticket, used to authorize rescheduling or revoking a confirmed ticket. Returned only for confirmed reservations. The format is configured per tenant, so do not validate it against a fixed length or pattern.

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

accessHistorylist of objectsOptional

admissionEntitlementslist of objectsOptional

Authentication

Path parameters

Headers

Query parameters

Response