airbnb Schedules API
Operations for managing experience schedules, time slots, and availability for hosted activities.
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-schedules-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 Activities Schedules API
description: The Airbnb Activities API allows approved partners to integrate with Airbnb Experiences, the platform's marketplace for hosted activities and tours.
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: Schedules
description: Operations for managing experience schedules, time slots, and availability for hosted activities.
paths:
/experiences/{experience_id}/schedules:
get:
operationId: listExperienceSchedules
summary: List Experience Schedules
description: Retrieves the available time slots and schedule entries for a specific experience over a date range.
tags:
- Schedules
parameters:
- $ref: '#/components/parameters/experienceIdParam'
- name: start_date
in: query
required: true
description: The start date for the schedule range in ISO 8601 format.
schema:
type: string
format: date
- name: end_date
in: query
required: true
description: The end date for the schedule range in ISO 8601 format.
schema:
type: string
format: date
responses:
'200':
description: The schedule entries for the specified date range.
content:
application/json:
schema:
type: object
properties:
schedules:
type: array
items:
$ref: '#/components/schemas/Schedule'
'400':
description: The date range is invalid or missing.
'401':
description: Authentication credentials are missing or invalid.
'404':
description: The experience was not found.
post:
operationId: createExperienceSchedule
summary: Create an Experience Schedule
description: Creates a new scheduled time slot for an experience, specifying the date, start time, and maximum number of attendees.
tags:
- Schedules
parameters:
- $ref: '#/components/parameters/experienceIdParam'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ScheduleCreate'
responses:
'201':
description: The schedule was successfully created.
content:
application/json:
schema:
$ref: '#/components/schemas/Schedule'
'400':
description: The request body contains invalid or missing fields.
'401':
description: Authentication credentials are missing or invalid.
'404':
description: The experience was not found.
/experiences/{experience_id}/schedules/{schedule_id}:
put:
operationId: updateExperienceSchedule
summary: Update an Experience Schedule
description: Updates an existing schedule entry for an experience, allowing changes to time, capacity, or cancellation of the time slot.
tags:
- Schedules
parameters:
- $ref: '#/components/parameters/experienceIdParam'
- $ref: '#/components/parameters/scheduleIdParam'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ScheduleUpdate'
responses:
'200':
description: The schedule was successfully updated.
content:
application/json:
schema:
$ref: '#/components/schemas/Schedule'
'400':
description: The request body contains invalid or missing fields.
'401':
description: Authentication credentials are missing or invalid.
'404':
description: The experience or schedule was not found.
delete:
operationId: deleteExperienceSchedule
summary: Delete an Experience Schedule
description: Removes a scheduled time slot from an experience. Existing bookings for the time slot must be handled before deletion.
tags:
- Schedules
parameters:
- $ref: '#/components/parameters/experienceIdParam'
- $ref: '#/components/parameters/scheduleIdParam'
responses:
'204':
description: The schedule was successfully deleted.
'401':
description: Authentication credentials are missing or invalid.
'404':
description: The experience or schedule was not found.
'409':
description: The schedule has active bookings and cannot be deleted.
components:
parameters:
experienceIdParam:
name: experience_id
in: path
required: true
description: The unique identifier of the experience.
schema:
type: string
scheduleIdParam:
name: schedule_id
in: path
required: true
description: The unique identifier of the schedule entry.
schema:
type: string
schemas:
Schedule:
type: object
properties:
id:
type: string
description: The unique identifier of the schedule entry.
experience_id:
type: string
description: The identifier of the associated experience.
date:
type: string
format: date
description: The date of the scheduled session.
start_time:
type: string
description: The start time in HH:MM format.
pattern: ^[0-2][0-9]:[0-5][0-9]$
end_time:
type: string
description: The end time in HH:MM format.
pattern: ^[0-2][0-9]:[0-5][0-9]$
max_guests:
type: integer
description: The maximum number of guests for this session.
minimum: 1
booked_guests:
type: integer
description: The current number of booked guests.
minimum: 0
available_spots:
type: integer
description: The number of remaining available spots.
minimum: 0
status:
type: string
description: The status of the schedule entry.
enum:
- open
- full
- cancelled
ScheduleUpdate:
type: object
properties:
start_time:
type: string
description: The updated start time in HH:MM format.
pattern: ^[0-2][0-9]:[0-5][0-9]$
max_guests:
type: integer
description: The updated maximum number of guests for this session.
minimum: 1
status:
type: string
description: The updated status of the schedule entry.
enum:
- open
- cancelled
ScheduleCreate:
type: object
required:
- date
- start_time
properties:
date:
type: string
format: date
description: The date of the scheduled session.
start_time:
type: string
description: The start time in HH:MM format.
pattern: ^[0-2][0-9]:[0-5][0-9]$
max_guests:
type: integer
description: Override the maximum number of guests for this specific session.
minimum: 1
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.
flows:
authorizationCode:
authorizationUrl: https://www.airbnb.com/oauth2/auth
tokenUrl: https://api.airbnb.com/v2/oauth2/authorizations
scopes:
experiences:read: Read experience information
experiences:write: Create and update experiences
bookings:read: Read booking information
bookings:write: Confirm and cancel bookings
messages:read: Read booking messages
messages:write: Send messages to guests
externalDocs:
description: Airbnb Developer Documentation
url: https://developer.withairbnb.com/