Login By Google

Returns an access_token, given a valid Google user OAuth access token. See the Google docs to learn how to generate a Google access token.
NOTE: The returned access_token is required to hit logged-in endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v1/authorize

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -d "client_id=3092nxybyb0otqw18e8nh5nty" -d "locale=en-US" -d "currency=USD" -F assertion_type=https://www.googleapis.com/oauth2/v1/userinfo -F assertion=va29.rgKq-cvJJ6IetZLecDvv2gxJ92tPYf5kEtL_PS98cEc5x1240n2aelp4uZ22xdWsLu2e -F prevent_account_creation=true https://api.airbnb.com/v1/authorize

Default Required URL Parameters:

Key Value Description
client_id 3092nxybyb0otqw18e8nh5nty API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Default Required Form Parameters:

Key Value Description
assertion_type https://www.googleapis.com/oauth2/v1/userinfo Required for Google authentication.
prevent_account_creation true For sign-in, as opposed to registration.

Required Form Parameters:

Key Sample Value Description
assertion va29.rgKq-cvJJ6IetZLecDvv2gxJ92tPYf5k... Google user's access token.

Login By Facebook

Returns an access_token, given a valid Facebook user OAuth access token. See the Facebook docs to learn how to generate an FB access token.
NOTE: The returned access_token is required to hit logged-in endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v1/authorize

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -d "client_id=3092nxybyb0otqw18e8nh5nty" -d "locale=en-US" -d "currency=USD" -F assertion_type=https://graph.facebook.com/me -F assertion=CAAAAIEMtwcwBAMTO70riSczKIgT3Nv0EnaZBWmObwt914WAJYRsxZAekHZBLnpqOauZAZATjpmZB8rQF58GlSK5mjX1RbrSXnS7OjkPhqjjKcArd6sDAz83V8zltWogJMsosYJHt7AIz60XTetwUiOmz7OS4rBllLvqBDsW1niOZBKKZBweWAdcasedZBNjbNfoVntlWFx7Uc2hpSR9ROWYAWjXqdHoyjkXafceeJsmCuTKDwZCED -F prevent_account_creation=true https://api.airbnb.com/v1/authorize

Default Required URL Parameters:

Key Value Description
client_id 3092nxybyb0otqw18e8nh5nty API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Default Required Form Parameters:

Key Value Description
assertion_type https://graph.facebook.com/me Required for Facebook authentication.
prevent_account_creation true For sign-in, as opposed to registration.

Required Form Parameters:

Key Sample Value Description
assertion CAAAAIEMtwcwBAMTO70riSczKIgT3Nv0E... Facebook user's access token.

Login By Email

Returns an access_token, given a valid user account email and password.
NOTE: The returned access_token is required to hit logged-in endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v1/authorize

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -d "client_id=3092nxybyb0otqw18e8nh5nty" -d "locale=en-US" -d "currency=USD" -F grant_type=password -F password=asdf1234 -F username=airbnbdev@gmail.com https://api.airbnb.com/v1/authorize

Default Required URL Parameters:

Key Value Description
client_id 3092nxybyb0otqw18e8nh5nty API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Default Required Form Parameters:

Key Value Description
grant_type password Required for email authentication (as opposed to OAuth)

Required Form Parameters:

Key Sample Value Description
username airbnbdev@gmail.com Account's email address
password asdf1234 Account's clear-text password (note: endpoint uses HTTPS)

Listing Search

Returns listings that fit the given search parameters.

Method: HTTP GET

Endpoint URL: https://api.airbnb.com/v2/search_results

Default Required URL Parameters:

Key Value Description
client_id 3092nxybyb0otqw18e8nh5nty API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Desired currency
_format for_search_results || for_search_results_with_minimal_pricing Search with pricing or not.
_limit 10 Number of listings to show at a time.
_offset 0 Number of listings to offset in search.
guests 1 Number of guests.
ib false Setting to true will only show listings that are instant bookable.
ib_add_photo_flow true Not sure.
location Los%20Angeles%2C%20CA Search by location name -- if unsure of lat/lng, etc.
min_bathrooms 0 Minimum number of bathrooms.
min_bedrooms 0 Minimum number of bedrooms.
min_beds 0 Minimum number of beds.
price_min 40 Minimum price.
price_max 210 Maximum price.
min_num_pic_urls 10 Minimum number of pictures.
sort 1 Sorting order (1: forward order, 0: reverse order).
suppress_facets true Not sure.
user_lat 37.18722222222222 Latitude search coordinate.
user_lng -122.42833333333333 Longitude search coordinate.

Get Reviews

Returns reviews for a given listing.

Method: HTTP GET

Endpoint URL: https://api.airbnb.com/v2/reviews

Default Required URL Parameters:

Key Value Description
client_id 3092nxybyb0otqw18e8nh5nty API Key
role all Not sure, but it's required.

Required URL Parameters:

Key Sample Value Description
listing_id 2056659 ID of the listing you'd like to view reviews for.

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Desired currency
_format for_mobile_client || for_search_results || for_search_results_with_minimal_pricing Not sure what the difference is.
_limit 10 Number of reviews to show at a time.
_offset 0 Number of reviews to offset.

View User Info

Returns detailed information about a user, given his/her/its ID (e.g., found in the view listing endpoint reponse).

Method: HTTP GET

Endpoint URL: https://api.airbnb.com/v2/users/(user ID here)

Default Required URL Parameters:

Key Value Description
client_id 3092nxybyb0otqw18e8nh5nty API Key
_format v1_legacy_show API result format (just put this -- it'll work without it, but it won't have as much data)

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings.

Get Host Listings

Returns information about all the listings a user hosts.

Method: HTTP GET

Endpoint URL: https://api.airbnb.com/v2/listings

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X GET -d "client_id=3092nxybyb0otqw18e8nh5nty" -d "locale=en-US" -d "currency=USD" -d "_format=v1_legacy_long" -d "_limit=10" -d "_offset=0" -d "has_availability=false" -d "user_id=57297136" https://api.airbnb.com/v2/listings

Default Required URL Parameters:

Key Value Description
client_id 3092nxybyb0otqw18e8nh5nty API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Desired currency
_format v1_legacy_long Not sure...
_limit 10 Max listings to return
_offset 0 Listing offset
has_availability false Whether to show listings that are currently active or not
user_id 57297136 The ID of the user whose listings you'd like to get

Required Header Parameters:

Key Sample Value Description

View Listing Info

Returns detailed information about a listing, given its ID (e.g., found in the search endpoint reponse).

Default Required URL Parameters:

Key Value Description
client_id 3092nxybyb0otqw18e8nh5nty API Key
_format v1_legacy_for_p3 API result format (just put this -- it won't work without it)

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
_source mobile_p3 Not sure. I'm guessing this means the request is coming from an Android mobile phone.
number_of_guests 1 Determines listing availability dates based on the # of guests.

Create Message Thread

Creates a message thread and a stay request, given a valid access token and a listing ID.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v1/threads/create

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -d "client_id=3092nxybyb0otqw18e8nh5nty" -d "locale=en-US" -d "currency=USD" -F "message=Hi!" -F "checkout_date=2018-04-02T22:00:00.000-0700" -F "checkin_date=2018-04-01T00:00:00.000-0700" -F  "number_of_guests=1" -F "listing_id=10166581" -H "X-Airbnb-OAuth-Token:3m0ky1cmj6jm4x3sjm8sx8osf" https://api.airbnb.com/v1/threads/create

Default Required URL Parameters:

Key Value Description
client_id 3092nxybyb0otqw18e8nh5nty API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Required Form Parameters:

Key Sample Value Description
listing_id 10166581 ID of the listing you'd like to message
number_of_guests 1 Number of guests in the request.
checkin_date 2018-04-01T00:00:00.000-0700 Requested check-in date.
checkout_date 2018-04-02T00:00:00.000-0700 Requested check-out date.
message Hi! Initial message to send (empty to send request only).

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm8sx8osf Airbnb auth token (from auth-ing with login endpoints)

Get Messages

Returns message threads, given an AirBnB access token (from authenticating with login endpoints).
NOTE: access_token is required to hit this endpoint.

Method: HTTP GET

Endpoint URL: https://api.airbnb.com/v1/threads

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X GET -d "client_id=3092nxybyb0otqw18e8nh5nty" -d "locale=en-US" -d "currency=USD" -d "offset=0" -d "items_per_page=10" -d "role=guest" -H "X-Airbnb-OAuth-Token:3m0ky1cmj6jm4x3sjm8sx8osf" https://api.airbnb.com/v1/threads

Default Required URL Parameters:

Key Value Description
client_id 3092nxybyb0otqw18e8nh5nty API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Desired currency
offset 0 Number of message threads to offset in search
items_per_page 10 Number of message threads to display at once
role guest Type of threads to retrieve. "guest", "host", or don't include this param for both

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm8sx8osf Airbnb auth token (from authing with login endpoints)

Get User Info

Get basic info about the logged-in user, such as name, picture, phone number, verifications, etc.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP GET

Endpoint URL: https://api.airbnb.com/v1/account/active

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X GET -H "X-Airbnb-OAuth-Token: 3m0ky1cmj6jm4x3sjm8sx8osf" https://api.airbnb.com/v1/account/active?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD&alert_types%5B%5D=reservation_request

Default Required URL Parameters:

Key Value Description
client_id 3092nxybyb0otqw18e8nh5nty API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Desired currency
offset 0 Number of message threads to offset in search
items_per_page 10 Number of message threads to display at once
role guest Type of threads to retrieve. "guest", "host", or don't include this param for both
alert_types%5B%5D reservation_request Not sure...

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm8sx8osf Airbnb auth token (from authing with login endpoints)

Get Host Messages

Returns host messages.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP GET

Endpoint URL: https://api.airbnb.com/v2/threads

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X GET -H "X-Airbnb-OAuth-Token: 9wled6f39td9vksj280twe10w" -d "client_id=3092nxybyb0otqw18e8nh5nty" -d "locale=en-US" -d "currency=USD" -d "_format=for_mobile_inbox" -d "_limit=10" -d "_offset=0" -d "role=host" https://api.airbnb.com/v2/threads

Default Required URL Parameters:

Key Value Description
client_id 3092nxybyb0otqw18e8nh5nty API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Desired currency
_format for_mobile_inbox Format. Not sure what values this takes.
_offset 0 Number of message threads to offset in search
_limit 10 Number of message threads to display at once
role host Type of threads to retrieve. "guest", "host", or don't include this param for both

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm8sx8osf Airbnb auth token (from auth-ing with login endpoints)

Pre-approve/Decline Reservation Request

Pre-approve or decline a request for reserving your listing.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v1/threads/184980528/update

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/x-www-form-urlencoded; charset=UTF-8" --data-binary "listing_id=11040894&message=&status=preapproved" --compressed https://api.airbnb.com/v1/threads/184980528/update?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD

Default Required URL Parameters:

Key Value Description
client_id 3092nxybyb0otqw18e8nh5nty API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Required Form Parameters:

Key Sample Value Description
listing_id 11040894 Listing ID for the reservation request.
message Hi%20there Message you'd like to add to the reservation response.
status preapproved Response to reservation request -- can be either "preapproved" or "denied"

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 9nwld6we4td9vkwj160teb49a Airbnb auth token (from auth-ing with login endpoints)

Get Reservation Requests

Returns information about all the listing reservation requests new, preapproved or declined.
Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X GET -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/x-www-form-urlencoded; charset=UTF-8" --compressed https://api.airbnb.com/v1/reservations/relationship?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD&thread_id=188111261

Default Required URL Parameters:

Key Value Description
client_id 3092nxybyb0otqw18e8nh5nty API Key

Required URL Parameters:

Key Sample Value Description
thread_id 188111261 The message thread associated with this reservation. (See "Get Host Messages")

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Desired currency

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 9nwld6we4td9vkwj160teb49a Airbnb auth token (from auth-ing with login endpoints)

Respond To Message

Respond to a message in a message thread (whether as a host or guest).
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v2/messages

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/json; charset=UTF-8" --data-binary '{"message":"Thanks!  I'd love to host you. -Nima","thread_id":"185143454"}' --compressed https://api.airbnb.com/v2/messages?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD

Default Required URL Parameters:

Key Value Description
client_id 3092nxybyb0otqw18e8nh5nty API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm3sx8osf Airbnb auth token (from auth-ing with login endpoints)
Content-Type application/json; charset=UTF-8 Content type

Body:

{"message":"Thanks! I'd love to host you. -Nima","thread_id":"185143454"}

Set "Other Things To Note"

This updates the "Other Things to Note" field of the listing.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v1/listings/12132179/update

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/json; charset=UTF-8" --data-binary '{"listing":{"notes":"Vhggh"}}' --compressed https://api.airbnb.com/v1/listings/12132179/update?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD

Default Required URL Parameters:

Key Value Description
client_id 9nwld6we4td9vkwj160teb49a API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm3sx8osf Airbnb auth token (from auth-ing with login endpoints)
Content-Type application/json; charset=UTF-8 Content type

Body:

{"listing":{"notes":"Vhggh"}}

Set "Neighborhood Overview"

This updates the "Neighborhood Overview" field of the listing.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v1/listings/12132179/update

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/json; charset=UTF-8" --data-binary '{"listing":{"neighborhood_overview":"sjjdjd"}}' --compressed https://api.airbnb.com/v1/listings/12132179/update?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD

Default Required URL Parameters:

Key Value Description
client_id 9nwld6we4td9vkwj160teb49a API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm3sx8osf Airbnb auth token (from auth-ing with login endpoints)
Content-Type application/json; charset=UTF-8 Content type

Body:

{"listing":{"neighborhood_overview":"sjjdjd"}}

Set Address

Respond to a message in a message thread (whether as a host or guest).
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v1/listings/12132179/update

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/json; charset=UTF-8" --data-binary '{"listing":{"apt":"","zipcode":"94087","street":"1641 Lachine Dr","state":"CA","lng":-122.0455591008067,"country_code":"US","lat":37.33981709659544,"city":"Sunnyvale"}}' --compressed https://api.airbnb.com/v1/listings/12132179/update?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD

Default Required URL Parameters:

Key Value Description
client_id 9nwld6we4td9vkwj160teb49a API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm3sx8osf Airbnb auth token (from auth-ing with login endpoints)
Content-Type application/json; charset=UTF-8 Content type

Body:

{"listing":{"apt":"","zipcode":"94087","street":"1641 Lachine Dr","state":"CA","lng":-122.0455591008067,"country_code":"US","lat":37.33981709659544,"city":"Sunnyvale"}}

Set Long-Term Prices

Set the weekly/monthly price of the listing.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v1/listings/12132179/update

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/json; charset=UTF-8" --data-binary '{"listing":{"listing_monthly_price_native":"1500","listing_weekly_price_native":"400"}}' --compressed https://api.airbnb.com/v1/listings/12132179/update?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD

Default Required URL Parameters:

Key Value Description
client_id 9nwld6we4td9vkwj160teb49a API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm3sx8osf Airbnb auth token (from auth-ing with login endpoints)
Content-Type application/json; charset=UTF-8 Content type

Body:

{"listing":{"listing_monthly_price_native":"1500","listing_weekly_price_native":"400"}}

Set Currency

Se the currency of the listing.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v1/listings/12132179/update

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/json; charset=UTF-8" --data-binary '{"listing":{"listing_native_currency":"CHF"}}' --compressed https://api.airbnb.com/v1/listings/12132179/update?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD

Default Required URL Parameters:

Key Value Description
client_id 9nwld6we4td9vkwj160teb49a API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm3sx8osf Airbnb auth token (from auth-ing with login endpoints)
Content-Type application/json; charset=UTF-8 Content type

Body:

{"listing":{"listing_native_currency":"CHF"}}

Set "About The Space"

This updates the "space" field of the listing.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v1/listings/12132179/update

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/json; charset=UTF-8" --data-binary '{"listing":{"space":"Shdhdh"}}' --compressed https://api.airbnb.com/v1/listings/12132179/update?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD

Default Required URL Parameters:

Key Value Description
client_id 9nwld6we4td9vkwj160teb49a API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm3sx8osf Airbnb auth token (from auth-ing with login endpoints)
Content-Type application/json; charset=UTF-8 Content type

Body:

{"listing":{"space":"Shdhdh"}}

Set "Guest Access"

This updates the "guest access" field of the listing.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v1/listings/12132179/update

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/json; charset=UTF-8" --data-binary '{"listing":{"access":"Hdjdj"}}' --compressed https://api.airbnb.com/v1/listings/12132179/update?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD

Default Required URL Parameters:

Key Value Description
client_id 9nwld6we4td9vkwj160teb49a API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm3sx8osf Airbnb auth token (from auth-ing with login endpoints)
Content-Type application/json; charset=UTF-8 Content type

Body:

{"listing":{"access":"Hdjdj"}}

Set "Interaction with Guests"

This updates the "Interaction with Guests" field of the listing.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v1/listings/12132179/update

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/json; charset=UTF-8" --data-binary '{"listing":{"interaction":"Shhdjd"}}' --compressed https://api.airbnb.com/v1/listings/12132179/update?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD

Default Required URL Parameters:

Key Value Description
client_id 9nwld6we4td9vkwj160teb49a API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm3sx8osf Airbnb auth token (from auth-ing with login endpoints)
Content-Type application/json; charset=UTF-8 Content type

Body:

{"listing":{"interaction":"Shhdjd"}}

Set Summary

Set the summary of the listing.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v1/listings/12132179/update

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/json; charset=UTF-8" --data-binary '{"listing":{"summary":"Testing."}}' --compressed https://api.airbnb.com/v1/listings/12132179/update?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD

Default Required URL Parameters:

Key Value Description
client_id 9nwld6we4td9vkwj160teb49a API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm3sx8osf Airbnb auth token (from auth-ing with login endpoints)
Content-Type application/json; charset=UTF-8 Content type

Body:

{"listing":{"summary":"Testing."}}

Set "Getting Around"

This updates the "Getting Around" field of the listing.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v1/listings/12132179/update

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/json; charset=UTF-8" --data-binary '{"listing":{"transit":"Gyugf"}}' --compressed https://api.airbnb.com/v1/listings/12132179/update?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD

Default Required URL Parameters:

Key Value Description
client_id 9nwld6we4td9vkwj160teb49a API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm3sx8osf Airbnb auth token (from auth-ing with login endpoints)
Content-Type application/json; charset=UTF-8 Content type

Body:

{"listing":{"transit":"Gyugf"}}

Set Title

Set the title of the listing.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v1/listings/12132179/update

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/json; charset=UTF-8" --data-binary '{"listing":{"name":"Test"}}' --compressed https://api.airbnb.com/v1/listings/12132179/update?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD

Default Required URL Parameters:

Key Value Description
client_id 9nwld6we4td9vkwj160teb49a API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm3sx8osf Airbnb auth token (from auth-ing with login endpoints)
Content-Type application/json; charset=UTF-8 Content type

Body:

{"listing":{"name":"Test"}}

Set Price

Set the price of the listing.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v1/listings/12132179/update

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/json; charset=UTF-8" --data-binary '{"listing":{"listing_price_native":"155"}}' --compressed https://api.airbnb.com/v1/listings/12132179/update?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD

Default Required URL Parameters:

Key Value Description
client_id 9nwld6we4td9vkwj160teb49a API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm3sx8osf Airbnb auth token (from auth-ing with login endpoints)
Content-Type application/json; charset=UTF-8 Content type

Body:

{"listing":{"listing_price_native":"155"}}

Set "House Rules"

This updates the "House Rules" field of the listing.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v1/listings/12132179/update

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/json; charset=UTF-8" --data-binary "{"listing":{"house_rules":"Ufifivi"}}" --compressed https://api.airbnb.com/v1/listings/12132179/update?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD

Default Required URL Parameters:

Key Value Description
client_id 9nwld6we4td9vkwj160teb49a API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm3sx8osf Airbnb auth token (from auth-ing with login endpoints)
Content-Type application/json; charset=UTF-8 Content type

Body:

{"listing":{"house_rules":"Ufifivi"}}

Set Amenities

This updates the "Amenities" of a listing.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v1/listings/12132179/update

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/json; charset=UTF-8" --data-binary '{"listing":{"amenities_ids":[40,1,8,3,7,15,17,36,37]}}' --compressed https://api.airbnb.com/v1/listings/12132179/update?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD

Default Required URL Parameters:

Key Value Description
client_id 9nwld6we4td9vkwj160teb49a API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm3sx8osf Airbnb auth token (from auth-ing with login endpoints)
Content-Type application/json; charset=UTF-8 Content type

Body:

{"listing":{"amenities_ids":[40,1,8,3,7,15,17,36,37]}}

Add Photo

Add a photo to the listing.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v1/listings/12132179/update

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: multipart/form-data; boundary=d27a2537-d9c1-40e4-b1f9-209eb38d45ff" -F name="photos[]" -F filename="~/Pictures/captured_photo1459370793915.jpg" https://api.airbnb.com/v1/listings/12132179/update?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD

Default Required URL Parameters:

Key Value Description
client_id 3092nxybyb0otqw18e8nh5nty API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Default Required Form Parameters:

Key Value Description
filename ~/Pictures/captured_photo1459370793915.jpg Filename location

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 9nwld6we4td9vkwj160teb49a Airbnb auth token (from auth-ing with login endpoints)

Turn On Instant Booking

This would allow a guest to "instant book" the listing.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v1/listings/12132179/update

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/json; charset=UTF-8" --data-binary '{"listing":{"instant_booking_visibility":"everyone"}}' --compressed https://api.airbnb.com/v1/listings/12132179/update?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD

Default Required URL Parameters:

Key Value Description
client_id 9nwld6we4td9vkwj160teb49a API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm3sx8osf Airbnb auth token (from auth-ing with login endpoints)
Content-Type application/json; charset=UTF-8 Content type

Body:

{"listing":{"instant_booking_visibility":"everyone"}}

Turn Off Instant Booking

This would allow a guest to "instant book" the listing.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v1/listings/12132179/update

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/json; charset=UTF-8" --data-binary '{"listing":{"instant_booking_visibility":"off"}}' --compressed https://api.airbnb.com/v1/listings/12132179/update?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD

Default Required URL Parameters:

Key Value Description
client_id 9nwld6we4td9vkwj160teb49a API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm3sx8osf Airbnb auth token (from auth-ing with login endpoints)
Content-Type application/json; charset=UTF-8 Content type

Body:

{"listing":{"instant_booking_visibility":"off"}}

Turn On Positive Review Instant Booking

This would allow a guest to "instant book" the listing.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v1/listings/12132179/update

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/json; charset=UTF-8" --data-binary '{"listing":{"instant_booking_visibility":"experienced"}}' --compressed https://api.airbnb.com/v1/listings/12132179/update?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD

Default Required URL Parameters:

Key Value Description
client_id 9nwld6we4td9vkwj160teb49a API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm3sx8osf Airbnb auth token (from auth-ing with login endpoints)
Content-Type application/json; charset=UTF-8 Content type

Body:

{"listing":{"instant_booking_visibility":"experienced"}}

Set Instant Booking Advance Notice Field

Sets the number of hours a user is allowed to instant book a listing.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v1/listings/12132179/update

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/json; charset=UTF-8" --data-binary '{"listing":{"instant_book_lead_time_hours":"72"}}' --compressed https://api.airbnb.com/v1/listings/12132179/update?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD

Default Required URL Parameters:

Key Value Description
client_id 9nwld6we4td9vkwj160teb49a API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm3sx8osf Airbnb auth token (from auth-ing with login endpoints)
Content-Type application/json; charset=UTF-8 Content type

Body:

{"listing":{"instant_book_lead_time_hours":"72"}}

Set Instant Booking Automated Message

Sets an automated message that will be sent when a user instant books the listing.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v1/listings/12132179/update

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/json; charset=UTF-8" --data-binary '{"listing":{"instant_book_welcome_message":"Hi there!  Welcome!"}}' --compressed https://api.airbnb.com/v1/listings/12132179/update?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD

Default Required URL Parameters:

Key Value Description
client_id 9nwld6we4td9vkwj160teb49a API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm3sx8osf Airbnb auth token (from auth-ing with login endpoints)
Content-Type application/json; charset=UTF-8 Content type

Body:

{"listing":{"instant_book_welcome_message":"Hi there! Welcome!"}}

Get Calendar Info

Get the calendar info for a listing the user is hosting.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP GET

Endpoint URL: https://api.airbnb.com/v2/batch/

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/json; charset=UTF-8" --data-binary '{"operations":[{"method":"GET","path":"/calendar_days","query":{"start_date":"2016-01-30","listing_id":"12132179","_format":"host_calendar","end_date":"2017-03-30"}},{"method":"GET","path":"/dynamic_pricing_controls/12132179","query":{}}],"_transaction":false}' --compressed https://api.airbnb.com/v2/batch/?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD

Default Required URL Parameters:

Key Value Description
client_id 9nwld6we4td9vkwj160teb49a API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm3sx8osf Airbnb auth token (from auth-ing with login endpoints)
Content-Type application/json; charset=UTF-8 Content type

Body:

{"operations":[{"method":"GET","path":"/calendar_days","query":{"start_date":"2016-01-30","listing_id":"12132179","_format":"host_calendar","end_date":"2017-03-30"}},{"method":"GET","path":"/dynamic_pricing_controls/12132179","query":{}}],"_transaction":false}

Create Empty Listing

Create empty listing to host -- you can update the listing with information in other requests.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v1/listings/create

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/json; charset=UTF-8" --data '{"room_type_category":"private_room","property_type_id":2,"bathrooms":1,"person_capacity":1,"beds":1,"bedrooms":1,"city":"Sunnyvale, California, US"}' --compressed https://api.airbnb.com/v1/listings/create?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD

Default Required URL Parameters:

Key Value Description
client_id 3092nxybyb0otqw18e8nh5nty API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 9nwld6we4td9vkwj160teb49a Airbnb auth token (from auth-ing with login endpoints)

Body:

{"room_type_category":"private_room","property_type_id":2,"bathrooms":1,"person_capacity":1,"beds":1,"bedrooms":1,"city":"Sunnyvale, California, US"}

Block Calendar Day

Make a user's hosted listing unbookable for a given calendar day
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.
Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X PUT -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/json; charset=UTF-8" --data-binary '{"availability":"unavailable"}' --compressed https://api.airbnb.com/v2/batch/?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD&_format=host_calendar

Default Required URL Parameters:

Key Value Description
client_id 9nwld6we4td9vkwj160teb49a API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings
_format host_calendar Specify to update host calendar.

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm3sx8osf Airbnb auth token (from auth-ing with login endpoints)
Content-Type application/json; charset=UTF-8 Content type

Body:

{"availability":"unavailable"}

Set Special Daily Pricing

Set special pricing for a specific day.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.
Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/json; charset=UTF-8" --data-binary '{"daily_price":60,"demand_based_pricing_overridden":true,"availability":"available"}' --compressed https://api.airbnb.com/v2/batch/?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD&_format=host_calendar

Default Required URL Parameters:

Key Value Description
client_id 9nwld6we4td9vkwj160teb49a API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings
_format host_calendar Specify to update host calendar.

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm3sx8osf Airbnb auth token (from auth-ing with login endpoints)
Content-Type application/json; charset=UTF-8 Content type

Body:

{"daily_price":60,"demand_based_pricing_overridden":true,"availability":"available"}

Activate/Deactive Listing

Make the user's listing active or deactivate the listing.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v1/listings/12132179/update

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/json; charset=UTF-8" --data-binary '{"listing":{"has_availability":true}}' --compressed https://api.airbnb.com/v1/listings/12132179/update?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD

Default Required URL Parameters:

Key Value Description
client_id 9nwld6we4td9vkwj160teb49a API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm3sx8osf Airbnb auth token (from auth-ing with login endpoints)
Content-Type application/json; charset=UTF-8 Content type

Body:

{"listing":{"has_availability":true}}

Delete Listing

Delete a listing on the user's host account.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.
Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/x-www-form-urlencoded; charset=UTF-8" https://api.airbnb.com/v1/listings/12132128/delete?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD

Default Required URL Parameters:

Key Value Description
client_id 9nwld6we4td9vkwj160teb49a API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm3sx8osf Airbnb auth token (from auth-ing with login endpoints)
Content-Type application/x-www-form-urlencoded; charset=UTF-8 Content type

Set "The Room and Beds"

This updates the "Room and Beds" of a listing.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v1/listings/12132179/update

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -d "client_id=3092nxybyb0otqw18e8nh5nty" -d "locale=en-US" -d "currency=USD" -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/json; charset=UTF-8" --data-binary '{"listing":{"property_type_id":"35","bathrooms":"2.0","room_type_category":"entire_home","person_capacity":"2","bedrooms":"2","beds":"2"}}' --compressed https://api.airbnb.com/v1/listings/12132179/update?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD

Default Required URL Parameters:

Key Value Description
client_id 9nwld6we4td9vkwj160teb49a API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm3sx8osf Airbnb auth token (from auth-ing with login endpoints)
Content-Type application/json; charset=UTF-8 Content type

Body:

{"listing":{"property_type_id":"35","bathrooms":"2.0","room_type_category":"entire_home","person_capacity":"2","bedrooms":"2","beds":"2"}}

Get Phone Number(s)

Get phone numbers that airbnb has to display to user so he/she can choose one to complete the security check and verify his/her account.
Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X GET -d "client_id=3092nxybyb0otqw18e8nh5nty" -d "locale=en-US" -d "currency=USD" -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/x-www-form-urlencoded; charset=UTF-8" --compressed  https://api.airbnb.com/v2/security_checks/57297136

Default Required URL Parameters:

Key Value Description
client_id 3092nxybyb0otqw18e8nh5nty API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Desired currency

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 9nwld6we4td9vkwj160teb49a Airbnb auth token (from auth-ing with login endpoints)

Submit Verification Code

Submit the security verification code to verify the account.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v2/security_checks/{userID}

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/json; charset=UTF-8" --data-binary '{"data":{"phone_number_id":27231699,"code":"0545"},"strategy":"phone_verification","activity_type":"mobile"}' --compressed https://api.airbnb.com/v2/security_checks/57297136?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD

Default Required URL Parameters:

Key Value Description
client_id 3092nxybyb0otqw18e8nh5nty API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm3sx8osf Airbnb auth token (from auth-ing with login endpoints)
Content-Type application/json; charset=UTF-8 Content type

Body:

{"data":{"phone_number_id":27231699,"code":"0545"},"strategy":"phone_verification","activity_type":"mobile"}

Request Verification Text

Text security code to selected phone number for account verification.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v2/security_checks

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/json; charset=UTF-8" --data-binary '{"data":{"phone_number_id":27231699,"verification_method":1},"strategy":"phone_verification","activity_type":"mobile"}' --compressed https://api.airbnb.com/v2/security_checks?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD

Default Required URL Parameters:

Key Value Description
client_id 3092nxybyb0otqw18e8nh5nty API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm3sx8osf Airbnb auth token (from auth-ing with login endpoints)
Content-Type application/json; charset=UTF-8 Content type

Body:

{"data":{"phone_number_id":27231699,"verification_method":1},"strategy":"phone_verification","activity_type":"mobile"}

Request Verification Call

Call the selected phone number to give the user the verification code for account verification.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v2/security_checks

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/json; charset=UTF-8" --data-binary '{"data":{"phone_number_id":27231699,"verification_method":0},"strategy":"phone_verification","activity_type":"mobile"}' --compressed https://api.airbnb.com/v2/security_checks?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD

Default Required URL Parameters:

Key Value Description
client_id 3092nxybyb0otqw18e8nh5nty API Key

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm3sx8osf Airbnb auth token (from auth-ing with login endpoints)
Content-Type application/json; charset=UTF-8 Content type

Body:

{"data":{"phone_number_id":27231699,"verification_method":0},"strategy":"phone_verification","activity_type":"mobile"}

Set ACH Info for Payout

Set the account's payout information so Airbnb can pay the user.
NOTE: This is a logged-in endpoint and requires an access_token. See Login Endpoints.

Method: HTTP POST

Endpoint URL: https://api.airbnb.com/v1/payout_infos/create_ach

Complete Curl Request (Press "Send to Hurl.it" to send in-browser test request):
curl -X POST -H "X-Airbnb-OAuth-Token: 9nwld6we4td9vkwj160teb49a" -H "Content-Type: application/x-www-form-urlencoded; charset=UTF-8" https://api.airbnb.com/v1/payout_infos/create_ach?client_id=3092nxybyb0otqw18e8nh5nty&locale=en-US&currency=USD&account_name=Bank+of+America&account_number=000043901948&account_type=Checking&country=US&payout_address1=1641+Lachine+Drive&payout_address2=&payout_city=Sunnyvale&payout_country=US&payout_state=CA&payout_zip=94087&routing_number=121000123

Default Required URL Parameters:

Key Value Description
client_id 9nwld6we4td9vkwj160teb49a API Key

Required URL Parameters:

Key Sample Value Description
account_name Bank+of+America Account name to save as
account_number 000043901448 Bank account number.
account_type Checking Bank account type ("Savings" or "Checking")
country US Not sure what this is for.
payout_address1 1641+Lachine+Drive Address1 of the payout
payout_address2 Suite+2 Address2 of the payout
payout_city Sunnyvale City of the payout
payout_country US Country of the payout
payout_state CA State of the payout
payout_zip 94087 Zip code of the payout
routing_number 121000123 Bank account routing number

Optional URL Parameters:

Key Sample Value Description
locale en-US Desired lagnuage
currency USD Currency for listings

Required Header Parameters:

Key Sample Value Description
X-Airbnb-OAuth-Token 3m0ky1cmj6jm4x3sjm3sx8osf Airbnb auth token (from auth-ing with login endpoints)
Content-Type application/x-www-form-urlencoded; charset=UTF-8 Content type