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 | string | Required | Airbnb listing ID (path parameter). Use decimal digits as a string in client code to preserve long IDs. |
| 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
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"
```

Response

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

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