# Ryanair Flight Details

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/ryanair/flight` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/ryanair-flight |

## Description

Retrieve a specific Ryanair flight by number and date to get real-time fare breakdown, seat availability, baggage policy, and booking status as structured JSON.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/ryanair/flight' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### FR 8492 Madrid to Barcelona, 20 Aug 2026

```json
{
  "fares": [
    {
      "price": 14.99,
      "taxes": 13.01,
      "currency": "EUR",
      "available": true,
      "cabin_class": "value",
      "total_price": 28,
      "seats_available": 9
    },
    {
      "price": 24.99,
      "taxes": 13.01,
      "currency": "EUR",
      "available": true,
      "cabin_class": "regular",
      "total_price": 38,
      "seats_available": 4
    },
    {
      "price": 44.99,
      "taxes": 13.01,
      "currency": "EUR",
      "available": true,
      "cabin_class": "plus",
      "total_price": 58,
      "seats_available": 2
    }
  ],
  "flight": {
    "origin": "MAD",
    "status": "scheduled",
    "destination": "BCN",
    "origin_city": "Madrid",
    "origin_name": "Adolfo Suárez Madrid-Barajas Airport",
    "arrival_time": "2026-08-20T07:45:00",
    "aircraft_type": "Boeing 737-8200",
    "flight_number": "FR 8492",
    "departure_time": "2026-08-20T06:25:00",
    "destination_city": "Barcelona",
    "destination_name": "Barcelona-El Prat Airport",
    "duration_minutes": 80,
    "terminal_arrival": "T1",
    "terminal_departure": "T2"
  },
  "booking": {
    "booking_url": "https://www.ryanair.com/gb/en/booking/home/MAD/BCN/2026-08-20/null/1/0/0/0",
    "last_seat_alert": false
  },
  "baggage_policy": {
    "currency": "EUR",
    "cabin_bag_price": 6,
    "checked_10kg_price": 14.99,
    "checked_20kg_price": 24.99,
    "small_bag_included": true
  }
}
```

## Documentation

## Overview

This endpoint retrieves the full detail view for a single Ryanair flight: all fare tiers with seat counts, the complete baggage pricing table, terminal assignments, and a direct booking link. Ryanair's HUMAN Security protection is handled by Piloterr.

## Quickstart

```
GET https://api.piloterr.com/v2/ryanair/flight?flight_number=FR8492&departure_date=2026-08-20
```

## Main use cases

- Build an ancillary cost calculator covering fares, bags, and seat selection for a specific Ryanair flight
- Track seat availability over time to model demand and fill rates on high-traffic routes
- Check flight status before triggering downstream booking workflows
- Compare fare tiers to identify the cheapest upgrade path on a given departure
- Enrich a travel itinerary app with terminal and aircraft information