GET

Airbnb Cancellation Policy from URL API

Get cancellation policies from any Airbnb URL. Simply paste the listing URL to check refund terms.

Overview

Easy URL Input

Copy and paste any Airbnb URL to see the cancellation policy and refund deadlines.

This endpoint accepts any Airbnb listing URL and returns the cancellation policy with refund milestones and deadlines.

Endpoint URL

GET https://api.stayapi.com/v1/airbnb/listing/cancellation-policy-from-url

Parameters

Parameter	Type	Required	Description
url	string	Required	Full Airbnb listing URL
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)

Response Structure

Cancellation Policy

policy_type - Policy category
title - Human-readable title
subtitle - Summary with deadline
milestones - Array of refund deadlines

Request

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

const params = new URLSearchParams({
  url: "https://www.airbnb.com/rooms/22135033",
  check_in: "2026-01-30",
  check_out: "2026-02-01"
});

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

const data = await response.json();
console.log(`Policy: ${data.cancellation_policy.title}`);

import requests

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

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

print(f"Policy: {data['cancellation_policy']['title']}")

<?php
$url = "https://api.stayapi.com/v1/airbnb/listing/cancellation-policy-from-url";
$params = http_build_query([
    "url" => "https://www.airbnb.com/rooms/22135033",
    "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);

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

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

uri = URI("https://api.stayapi.com/v1/airbnb/listing/cancellation-policy-from-url")
uri.query = URI.encode_www_form({
  url: "https://www.airbnb.com/rooms/22135033",
  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)

puts "Policy: \#{data['cancellation_policy']['title']}"

Response

{
  "success": true,
  "listing_id": 22135033,
  "source_url": "https://www.airbnb.com/rooms/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."
      }
    ]
  }
}

{
  "error": "Invalid URL",
  "detail": "Could not extract listing ID from URL",
  "status_code": 400
}