Reschedule an appointment

POST

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

Moves an appointment ticket to a new time. Only appointment tickets currently in
waiting status can be rescheduled (enforced by validation on id).

Prerequisites

id — a 10-char ticket that is an appointment (isAppointment = true) and is in
waiting status.

time — the new UTC ISO-8601 datetime (with trailing Z).

A customer — exactly one of customerId or customerExternalId, matching a customer
in your company.

Behavioural notes

The response is the resolved ticket at its new time.

If the underlying ticket cannot be resolved after the change, the API returns 404
with error = "Ticket not found.".

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

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Ticket updated successfully.

Bodyapplication/json

🟠400

🟠404

🟠422

🟠401Unauthorized

🔴500ServerError

Request Example

Shell

JavaScript

Java

Swift

cURL

Reschedule using internal customer idReschedule using your external customer id

curl --location 'https://api-dev.skiplino.com/external/v1/tickets/k7m2p9x4q1/change-time' \
--header 'X-Locale;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "time": "2026-07-02T13:00:00.000Z",
    "customerId": "9f2c8b7a4e1d6c3f0a5b8e2d7c4f1a9b"
}'

Response Example

200 - Success

{
    "message": "Ticket updated successfully.",
    "data": {
        "id": "k7m2p9x4q1",
        "ticketNumber": "A042",
        "status": "waiting",
        "statusAt": "2026-06-23T11:25:00.000Z",
        "type": "appointment",
        "time": "2026-07-02T13:00:00.000Z",
        "branch": {
            "id": "802b33af66",
            "name": "Seef Mall Branch"
        },
        "service": {
            "id": "802b33af66",
            "name": "Account Opening"
        },
        "groupOfService": {
            "id": "7c1f9a3b2d",
            "name": "Teller Services"
        },
        "customer": {
            "id": "9f2c8b7a4e1d6c3f0a5b8e2d7c4f1a9b",
            "name": "Layla Hassan"
        },
        "bookedAt": "2026-06-23T11:05:22.000Z"
    }
}

Cancel a ticket

Create a customer