Cancel Booking (Public) - Plugixa Car Wash for WordPress

Cancel Booking (Public) - Plugixa Car Wash

POST /plugixa-carwash/v1/public/bookings/{token}/cancel

Cancel a booking with its private token, up to the cut-off set in Settings -> Bookings (24 hours before the start by default).

Open to anyone who has the token: no sign-in. Rate-limited per visitor address to 10 an hour (bucket carwash_cancel).

Note. A booking that is already cancelled answers 200 unchanged.

Request

POST https://your-site.example/wp-json/plugixa-carwash/v1/public/bookings/9f1c2e7a5b3d4c6e8f0a1b2c3d4e5f60/cancel

Path parameters

Name	Type	Description
`token`	`string`	The booking’s 32-character token

Responses

`200` OK. `data` is the cancelled booking.

{
  "success": true,
  "data": {
    "number": "CW2026-0043",
    "token": "9f1c2e7a5b3d4c6e8f0a1b2c3d4e5f60",
    "status": "cancelled",
    "location": "Riverside",
    "date": "2026-11-14",
    "time": "09:00",
    "start_at": "2026-11-14 15:00:00",
    "end_at": "2026-11-14 16:00:00",
    "duration": 60,
    "items": [
      {
        "name": "Deluxe",
        "price": 49.0,
        "role": "package"
      },
      {
        "name": "Coupon SPRING10",
        "price": -4.9,
        "role": "discount"
      }
    ],
    "subtotal": 44.1,
    "tax": 2.76,
    "total": 46.86,
    "currency": "USD",
    "first_name": "Emma",
    "email": "emma@example.com",
    "payment_status": "unpaid",
    "payment_method": "cash",
    "discount": 4.9,
    "paid": 0.0,
    "due": 46.86,
    "can_cancel": false
  }
}

Field	Type	Meaning
`data.status`	`string`	`cancelled`
`data.can_cancel`	`boolean`	`false` from now on

The cancellation is written in the booking’s history as “Cancelled by the customer”, frees the bay, and runs the same e-mails and webhooks as a cancellation by staff.

Errors

Status	Code	When
`404`	`plugixa_carwash_not_found`	No booking with that token.
`409`	`plugixa_carwash_too_late_to_cancel`	The cut-off has passed: “Bookings can be cancelled online up to 24 hours before. Please call us instead.”
`409`	`plugixa_carwash_invalid_transition`	The booking can no longer be cancelled, for example it is `completed`.
`429`	`plugixa_carwash_rate_limited`	This address has used up its requests for the hour.

Plus the errors every endpoint can return.

Examples

curl -s -X POST "https://your-site.example/wp-json/plugixa-carwash/v1/public/bookings/9f1c2e7a5b3d4c6e8f0a1b2c3d4e5f60/cancel"

<?php
$ch = curl_init('https://your-site.example/wp-json/plugixa-carwash/v1/public/bookings/9f1c2e7a5b3d4c6e8f0a1b2c3d4e5f60/cancel');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_RETURNTRANSFER => true,
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

const response = await fetch('https://your-site.example/wp-json/plugixa-carwash/v1/public/bookings/9f1c2e7a5b3d4c6e8f0a1b2c3d4e5f60/cancel', {
  method: 'POST',
});
const { data } = await response.json();