# Ryanair API Documentation

<p><strong>Ryanair API Documentation</strong> Pass two IATA codes and a date. The answer holds each flight with a numeric price and currency, local and UTC departure times, duration, flight number and the number of fares left. One request performs one upstream lookup and costs one credit when it succeeds.</p>

- **Documentation:** [https://scrappa.co/docs/ryanair-api/ryanair_flights_availability](https://scrappa.co/docs/ryanair-api/ryanair_flights_availability)
- **API group:** Ryanair API
- **Endpoint:** `GET https://scrappa.co/api/ryanair/flights/availability`

## 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 |
| --- | --- | --- | --- |
| `origin` | string | Yes | Origin IATA code |
| `destination` | string | Yes | Destination IATA code |
| `date` | string | Yes | Departure date, YYYY-MM-DD |
| `adults` | integer | No | Adult passengers, 1 to 9 |
| `flex` | integer | No | Flexible days before and after, 0 to 3 |

## Example response

```json
{
    "data": {
        "flights": [
            {
                "date": "2026-12-01",
                "fares": [
                    {
                        "value": 24.99,
                        "currency": "EUR"
                    }
                ],
                "fares_left": 5,
                "flight_number": "FR123",
                "departure_time_utc": "06:20",
                "departure_time_local": "06:20"
            }
        ]
    },
    "meta": {
        "credits": 1,
        "billable": true
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. This response is not billed. |

## 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)
