# Trip.com Flight Price Calendar API Documentation

<p><strong>Trip.com Flight Price Calendar API Documentation</strong> Get the cheapest price for each departure day of a route, from the given date on, one-way, or round trip with return_date. Use IATA city codes such as LON or NYC. Airport codes such as JFK return no rows and the call fails without a charge. Each day has the date in ISO 8601, the price as a number in the requested currency and whether the cheapest option is direct. The answer has about 200 days. Cost: 1 credit. Failed or empty calls cost 0.</p>

- **Documentation:** [https://scrappa.co/docs/tripcom-api/tripcom_flights_calendar](https://scrappa.co/docs/tripcom-api/tripcom_flights_calendar)
- **API group:** Trip.com API
- **Endpoint:** `GET https://scrappa.co/api/tripcom/flights/calendar`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `from` | string | Yes | Departure IATA city code, uppercase. Example: LON. |
| `to` | string | Yes | Arrival IATA city code, uppercase. Example: PAR. |
| `date` | string | Yes | First departure date, YYYY-MM-DD, today or later. Example: 2027-03-14. |
| `return_date` | string | No | Return date for a round-trip calendar, YYYY-MM-DD, on or after date. Without it the calendar is one way. |
| `currency` | string | No | Price currency: USD, EUR, GBP, JPY or KRW. Defaults to USD. |

## Example response

```json
{
    "data": {
        "to": "PAR",
        "date": "2027-03-14",
        "days": [
            {
                "date": "2027-03-14",
                "price": 41,
                "direct": true
            },
            {
                "date": "2027-03-15",
                "price": 29,
                "direct": false
            }
        ],
        "from": "LON",
        "total": 2,
        "adults": 1,
        "currency": "EUR",
        "trip_type": "one_way",
        "cabin_class": "economy",
        "return_date": null,
        "lowest_price": 29
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "flight_search"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. |
| 404 | Resource Not Found | The id is unknown. This response is not billable. |
| 502 | Unexpected Upstream Answer | Trip.com answered with a page or payload Scrappa cannot read. This response is not billable. Retry later. |
| 503 | Upstream Unavailable | Trip.com did not answer after one retry. This response is not billable. Retry later. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)