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
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"
```

Response

```json
{
  "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."
      }
    ]
  }
}
```

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