Cancel a booking

POST

/v3/api/business/reseller/bookings/{bookingId}/cancel

Cancels a booking. Works for both spa and class bookings. Credits are refunded based on the provider's cancellation policy.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Responses

🟢200

*/*

Cancelled booking

Body*/*

🟠401

🟠403

🟠404

🟠409

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/v3/api/business/reseller/bookings/booking_2a4f8e1b3c5d9f7a/cancel' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "object": "booking",
    "id": "booking_2a4f8e1b3c5d9f7a",
    "status": "CANCELLED",
    "type": "SPA",
    "service_name": "Deep Tissue Massage",
    "provider_name": "Zen Wellness Spa",
    "date": "2026-05-10",
    "time": "14:00",
    "scheduled_for": 1746878400000,
    "credits_deducted": 5,
    "cancelled_at": 1746800000000,
    "refund": {
        "credits_refunded": 5,
        "amount_refunded": 0,
        "currency": "NGN"
    },
    "created": 1746700000000,
    "message": "Booking cancelled successfully"
}

Modified at 2026-05-21 13:30:24

Get booking status

Introduction