airbnb · Schema

Booking

Properties

Name	Type	Description
id	string	The unique identifier of the booking.
confirmation_code	string	The human-readable confirmation code for the booking.
status	string	The current status of the booking.
experience_id	string	The identifier of the booked experience.
schedule_id	string	The identifier of the booked schedule entry.
guest	object
guests_count	integer	The number of guests included in the booking.
total_price	number	The total price of the booking.
currency	string	The ISO 4217 currency code for the booking pricing.
host_payout	number	The amount to be paid out to the host after fees.
created_at	string	The timestamp when the booking was created.
updated_at	string	The timestamp when the booking was last updated.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/airbnb/refs/heads/main/json-schema/airbnb-booking-schema.json",
  "title": "Booking",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The unique identifier of the booking."
    },
    "confirmation_code": {
      "type": "string",
      "description": "The human-readable confirmation code for the booking."
    },
    "status": {
      "type": "string",
      "description": "The current status of the booking.",
      "enum": [
        "pending",
        "confirmed",
        "cancelled",
        "completed"
      ]
    },
    "experience_id": {
      "type": "string",
      "description": "The identifier of the booked experience."
    },
    "schedule_id": {
      "type": "string",
      "description": "The identifier of the booked schedule entry."
    },
    "guest": {
      "$ref": "#/components/schemas/BookingGuest"
    },
    "guests_count": {
      "type": "integer",
      "description": "The number of guests included in the booking.",
      "minimum": 1
    },
    "total_price": {
      "type": "number",
      "format": "double",
      "description": "The total price of the booking."
    },
    "currency": {
      "type": "string",
      "description": "The ISO 4217 currency code for the booking pricing.",
      "pattern": "^[A-Z]{3}$"
    },
    "host_payout": {
      "type": "number",
      "format": "double",
      "description": "The amount to be paid out to the host after fees."
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "description": "The timestamp when the booking was created."
    },
    "updated_at": {
      "type": "string",
      "format": "date-time",
      "description": "The timestamp when the booking was last updated."
    }
  }
}