airbnb Reservations API
Operations for managing reservations, including accepting, declining, and retrieving booking details.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/airbnb-reservations-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Airbnb Homes Reservations API
description: The Airbnb Homes API provides approved connectivity partners with programmatic access to manage vacation rental listings on the Airbnb platform.
version: 2025.03.31
contact:
name: Airbnb Developer Support
url: https://developer.withairbnb.com/
termsOfService: https://www.airbnb.com/terms
servers:
- url: https://api.airbnb.com/v2
description: Airbnb Production API Server
security:
- oauth2: []
tags:
- name: Reservations
description: Operations for managing reservations, including accepting, declining, and retrieving booking details.
paths:
/reservations:
get:
operationId: listReservations
summary: List Reservations
description: Retrieves a paginated list of reservations for listings managed by the authenticated partner. Supports filtering by status, listing, and date range.
tags:
- Reservations
parameters:
- $ref: '#/components/parameters/limitParam'
- $ref: '#/components/parameters/offsetParam'
- name: status
in: query
description: Filter reservations by their current status.
schema:
type: string
enum:
- pending
- accepted
- denied
- cancelled
- checked_in
- checked_out
- name: listing_id
in: query
description: Filter reservations by listing identifier.
schema:
type: string
- name: start_date
in: query
description: Filter reservations with check-in dates on or after this date.
schema:
type: string
format: date
- name: end_date
in: query
description: Filter reservations with check-in dates on or before this date.
schema:
type: string
format: date
responses:
'200':
description: A paginated list of reservations.
content:
application/json:
schema:
type: object
properties:
reservations:
type: array
items:
$ref: '#/components/schemas/Reservation'
pagination:
$ref: '#/components/schemas/Pagination'
'401':
description: Authentication credentials are missing or invalid.
/reservations/{reservation_id}:
get:
operationId: getReservation
summary: Get a Reservation
description: Retrieves the full details of a specific reservation including guest information, dates, pricing breakdown, and current status.
tags:
- Reservations
parameters:
- $ref: '#/components/parameters/reservationIdParam'
responses:
'200':
description: The reservation details.
content:
application/json:
schema:
$ref: '#/components/schemas/Reservation'
'401':
description: Authentication credentials are missing or invalid.
'404':
description: The reservation was not found.
/reservations/{reservation_id}/accept:
post:
operationId: acceptReservation
summary: Accept a Reservation
description: Accepts a pending reservation request. Once accepted, the reservation is confirmed and the calendar dates are blocked.
tags:
- Reservations
parameters:
- $ref: '#/components/parameters/reservationIdParam'
responses:
'200':
description: The reservation was successfully accepted.
content:
application/json:
schema:
$ref: '#/components/schemas/Reservation'
'401':
description: Authentication credentials are missing or invalid.
'404':
description: The reservation was not found.
'409':
description: The reservation is not in a pending state.
/reservations/{reservation_id}/deny:
post:
operationId: denyReservation
summary: Deny a Reservation
description: Denies a pending reservation request. A reason for denial may be provided to inform the guest.
tags:
- Reservations
parameters:
- $ref: '#/components/parameters/reservationIdParam'
requestBody:
content:
application/json:
schema:
type: object
properties:
reason:
type: string
description: The reason for denying the reservation request.
responses:
'200':
description: The reservation was successfully denied.
content:
application/json:
schema:
$ref: '#/components/schemas/Reservation'
'401':
description: Authentication credentials are missing or invalid.
'404':
description: The reservation was not found.
'409':
description: The reservation is not in a pending state.
/reservations/{reservation_id}/cancel:
post:
operationId: cancelReservation
summary: Cancel a Reservation
description: Cancels an accepted reservation. Cancellation policies and fees may apply depending on the listing configuration and timing.
tags:
- Reservations
parameters:
- $ref: '#/components/parameters/reservationIdParam'
requestBody:
content:
application/json:
schema:
type: object
properties:
reason:
type: string
description: The reason for cancelling the reservation.
responses:
'200':
description: The reservation was successfully cancelled.
content:
application/json:
schema:
$ref: '#/components/schemas/Reservation'
'401':
description: Authentication credentials are missing or invalid.
'404':
description: The reservation was not found.
'409':
description: The reservation cannot be cancelled in its current state.
components:
parameters:
limitParam:
name: limit
in: query
description: The maximum number of results to return per page.
schema:
type: integer
minimum: 1
maximum: 100
default: 25
reservationIdParam:
name: reservation_id
in: path
required: true
description: The unique identifier of the reservation.
schema:
type: string
offsetParam:
name: offset
in: query
description: The number of results to skip for pagination.
schema:
type: integer
minimum: 0
default: 0
schemas:
Guest:
type: object
properties:
id:
type: string
description: The unique identifier of the guest.
first_name:
type: string
description: The first name of the guest.
last_name:
type: string
description: The last name of the guest.
phone:
type: string
description: The phone number of the guest, available after booking is confirmed.
profile_picture_url:
type: string
format: uri
description: The URL of the guest profile picture.
verified:
type: boolean
description: Whether the guest has completed identity verification.
Pagination:
type: object
properties:
total:
type: integer
description: The total number of results available.
limit:
type: integer
description: The number of results returned per page.
offset:
type: integer
description: The current offset in the result set.
has_more:
type: boolean
description: Whether more results are available beyond this page.
Reservation:
type: object
properties:
id:
type: string
description: The unique identifier of the reservation.
confirmation_code:
type: string
description: The human-readable confirmation code for the reservation.
status:
type: string
description: The current status of the reservation.
enum:
- pending
- accepted
- denied
- cancelled
- checked_in
- checked_out
listing_id:
type: string
description: The identifier of the listing that was booked.
guest:
$ref: '#/components/schemas/Guest'
check_in:
type: string
format: date
description: The guest check-in date.
check_out:
type: string
format: date
description: The guest check-out date.
nights:
type: integer
description: The total number of nights in the reservation.
minimum: 1
guests_count:
type: integer
description: The number of guests included in the reservation.
minimum: 1
total_price:
type: number
format: double
description: The total price of the reservation in the listing currency.
currency:
type: string
description: The ISO 4217 currency code for the reservation 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 reservation was created.
updated_at:
type: string
format: date-time
description: The timestamp when the reservation was last updated.
securitySchemes:
oauth2:
type: oauth2
description: Airbnb uses OAuth 2.0 for authentication. Partners must register their application to receive a client ID and secret, then obtain access tokens through the authorization code flow. Access tokens expire after 24 hours and must be refreshed.
flows:
authorizationCode:
authorizationUrl: https://www.airbnb.com/oauth2/auth
tokenUrl: https://api.airbnb.com/v2/oauth2/authorizations
scopes:
listings:read: Read listing information
listings:write: Create and update listings
reservations:read: Read reservation information
reservations:write: Accept, deny, and cancel reservations
messages:read: Read reservation messages
messages:write: Send messages to guests
reviews:read: Read reviews
calendar:read: Read calendar availability
calendar:write: Update calendar availability and pricing
externalDocs:
description: Airbnb Developer Documentation
url: https://developer.withairbnb.com/