GET

Airbnb Cancellation Policy API

Get cancellation policies with refund terms, deadlines, and milestone dates for any Airbnb listing.

Overview

Date-Specific Policies

Cancellation deadlines are calculated based on your check-in date. Always verify before booking.

The Airbnb Cancellation Policy endpoint returns the listing's cancellation terms including policy type, refund percentages, and deadline milestones. Essential for understanding what happens if plans change.

Endpoint URL

GET https://api.stayapi.com/v1/airbnb/listing/{listing_id}/cancellation-policy

Parameters

Parameter	Type	Required	Description
listing_id	integer	Required	Airbnb listing ID (path parameter)
check_in	string	Required	Check-in date in YYYY-MM-DD format
check_out	string	Required	Check-out date in YYYY-MM-DD format
adults	integer	Optional	Number of adults (1-16, default: 1)

Policy Types

CANCEL_FLEXIBLE - Full refund up to 24 hours before check-in
CANCEL_MODERATE - Full refund up to 5 days before check-in
CANCEL_STRICT - 50% refund up to 7 days before check-in
NON_REFUNDABLE - No refund available

Response Structure

Policy Information

policy_type - Policy category (e.g., CANCEL_MODERATE)
title - Human-readable title (e.g., "Free cancellation")
subtitle - Summary with deadline date

Milestones

refund_type - Type of refund (Full, Partial, None)
deadline - Deadline timestamp (ISO 8601)
refund_term - Detailed refund description

Request

curl -X GET "https://api.stayapi.com/v1/airbnb/listing/22135033/cancellation-policy?check_in=2026-01-30&check_out=2026-02-01" \
  -H "x-api-key: YOUR_API_KEY"

const listingId = 22135033;
const params = new URLSearchParams({
  check_in: "2026-01-30",
  check_out: "2026-02-01"
});

const response = await fetch(
  `https://api.stayapi.com/v1/airbnb/listing/${listingId}/cancellation-policy?${params}`,
  {
    headers: {
      "x-api-key": "YOUR_API_KEY"
    }
  }
);

const data = await response.json();
const policy = data.cancellation_policy;

console.log(`Policy: ${policy.title}`);
console.log(`Type: ${policy.policy_type}`);

// Show milestones
policy.milestones.forEach(m => {
  console.log(`${m.refund_type}: ${m.refund_term}`);
  console.log(`Deadline: ${m.deadline}`);
});

import requests

listing_id = 22135033
url = f"https://api.stayapi.com/v1/airbnb/listing/{listing_id}/cancellation-policy"
headers = {"x-api-key": "YOUR_API_KEY"}
params = {
    "check_in": "2026-01-30",
    "check_out": "2026-02-01"
}

response = requests.get(url, headers=headers, params=params)
data = response.json()

policy = data["cancellation_policy"]
print(f"Policy: {policy['title']}")
print(f"Type: {policy['policy_type']}")

for m in policy["milestones"]:
    print(f"{m['refund_type']}: {m['refund_term']}")

<?php
$listingId = 22135033;
$url = "https://api.stayapi.com/v1/airbnb/listing/" . $listingId . "/cancellation-policy";
$params = http_build_query([
    "check_in" => "2026-01-30",
    "check_out" => "2026-02-01"
]);

$ch = curl_init($url . "?" . $params);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-api-key: YOUR_API_KEY"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

$policy = $data["cancellation_policy"];
echo "Policy: " . $policy["title"] . "\n";
?>

require "net/http"
require "json"
require "uri"

listing_id = 22135033
uri = URI("https://api.stayapi.com/v1/airbnb/listing/\#{listing_id}/cancellation-policy")
uri.query = URI.encode_www_form({
  check_in: "2026-01-30",
  check_out: "2026-02-01"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request["x-api-key"] = "YOUR_API_KEY"

response = http.request(request)
data = JSON.parse(response.body)

policy = data["cancellation_policy"]
puts "Policy: \#{policy['title']}"
puts "Type: \#{policy['policy_type']}"

policy["milestones"].each do |m|
  puts "\#{m['refund_type']}: \#{m['refund_term']}"
end

Response

{
  "success": true,
  "listing_id": 22135033,
  "check_in": "2026-01-30",
  "check_out": "2026-02-01",
  "nights": 2,
  "cancellation_policy": {
    "policy_type": "CANCEL_MODERATE",
    "title": "Free cancellation",
    "subtitle": "Cancel before January 25 for a full refund.",
    "milestones": [
      {
        "refund_type": "Full refund",
        "deadline": "2026-01-25T13:00:00.000Z",
        "refund_term": "Get back 100% of what you paid."
      },
      {
        "refund_type": "Partial refund",
        "deadline": "2026-01-30T13:00:00.000Z",
        "refund_term": "Get back 50% of every night but the first one."
      }
    ],
    "disclaimers": [
      "Service fees are refunded when you cancel before check-in."
    ]
  }
}

{
  "error": "Invalid dates",
  "detail": "check_out must be after check_in",
  "status_code": 400
}