Fetch a ticket

GET

https://api-dev.skiplino.com/external/v1/tickets/{id}

Returns the current state of a ticket, including live queue intelligence for tickets
that are still waiting. Poll this endpoint to track a customer's position in real time.

Behavioural notes

For tickets with status = "waiting", the response adds:

queueSize — number of people ahead in the queue.

waitingTime — estimated wait in minutes (rounded).

These two fields are absent for non-waiting tickets (e.g. upcoming, serving,
served, cancelled).

Needs Product Confirmation — The full enumeration of status and type values
is not centralized in the external layer. Known status values include waiting,
upcoming, serving, served, and cancelled. Treat the set as open-ended.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Header Params

Responses

🟢200

application/json

Ticket fetched successfully.

Bodyapplication/json

🟠400

🟠422

🟠401Unauthorized

🔴500ServerError

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api-dev.skiplino.com/external/v1/tickets/k7m2p9x4q1' \
--header 'X-Locale;' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "message": "Ticket fetched successfully.",
    "data": {
        "id": "k7m2p9x4q1",
        "ticketNumber": "Q017",
        "status": "waiting",
        "statusAt": "2026-06-23T11:10:00.000Z",
        "type": "sequential",
        "time": null,
        "branch": {
            "id": "802b33af66",
            "name": "Seef Mall Branch"
        },
        "service": {
            "id": "6fe8fb8b12",
            "name": "Cash Withdrawal"
        },
        "groupOfService": {
            "id": "7c1f9a3b2d",
            "name": "Teller Services"
        },
        "customer": {
            "id": "9f2c8b7a4e1d6c3f0a5b8e2d7c4f1a9b",
            "name": "Layla Hassan"
        },
        "bookedAt": "2026-06-23T11:08:41.000Z",
        "queueSize": 6,
        "waitingTime": 18
    }
}

Book a ticket (walk-in or appointment)

Cancel a ticket