Cancel a ticket

POST

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

Cancels a ticket that is still cancellable. Only tickets with status waiting or
upcoming can be cancelled; any other state returns 409 Conflict.

Behavioural notes

waiting tickets (walk-in queue) are cancelled via the queue cancel path; upcoming
tickets (appointments) are cancelled via the appointment cancel path. The client does
not need to distinguish — just call this endpoint.

The response is the resolved ticket reflecting its new (cancelled) state.

The request body is empty.

Cancelling an already-cancelled or already-served ticket returns 409.

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 cancelled successfully.

Bodyapplication/json

🟠409

🟠422

🟠401Unauthorized

🔴500ServerError

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Success

{
    "message": "Ticket cancelled successfully.",
    "data": {
        "id": "k7m2p9x4q1",
        "ticketNumber": "Q017",
        "status": "cancelled",
        "statusAt": "2026-06-23T11:20: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"
    }
}

Fetch a ticket

Reschedule an appointment