Booking cancel — Airbnb

airbnb.booking.cancel

Cancel a reservation against a fresh reviewed quote and verify its status

POST /v1/operations/airbnb.booking.cancel

Headers

Authorization: Bearer YOUR_AJAR_API_KEY
x-skyscanner-token: YOUR_SKYSCANNER_TOKEN
x-idempotency-key: YOUR_UNIQUE_ATTEMPT_KEY
Content-Type: application/json

x-idempotency-key identifies one intended action. Generate a unique value, such as crypto.randomUUID(), before sending it. Use 1–128 letters, numbers, hyphens, underscores or periods. A duplicate attempt is rejected; it does not return a cached success. If a request times out, check the provider’s state before starting a new attempt with a new key. See the idempotency guide.

Inputs

Parameter	Example type	Example value
quote_ref	string	"returned-executable-cancellation-quote"
intent	object	{"trip_id":"returned-single-stay-trip-id","reason_id":"returned-reason-id","message_airbnb":"My travel arrangements have changed and I cannot stay.","message_host":""}

Example input

{
  "quote_ref": "returned-executable-cancellation-quote",
  "intent": {
    "trip_id": "returned-single-stay-trip-id",
    "reason_id": "returned-reason-id",
    "message_airbnb": "My travel arrangements have changed and I cannot stay.",
    "message_host": ""
  }
}

Open JSON schema

Input schema

{
  "$id": "https://useajar.com/schemas/airbnb/booking-cancel.input.schema.json",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "intent": {
      "additionalProperties": false,
      "properties": {
        "message_airbnb": {
          "default": "",
          "maxLength": 4000,
          "type": "string"
        },
        "message_host": {
          "default": "",
          "maxLength": 4000,
          "type": "string"
        },
        "reason_id": {
          "maxLength": 1024,
          "minLength": 1,
          "type": "string"
        },
        "trip_id": {
          "maxLength": 1024,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "trip_id"
      ],
      "type": "object"
    },
    "quote_ref": {
      "maxLength": 2048,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "quote_ref",
    "intent"
  ],
  "type": "object"
}