# Opodo Flight Search API Documentation

<p><strong>Opodo Flight Search API Documentation</strong> Pass origin and destination as three-letter IATA codes, a departure date, optional return date and passengers. Each offer keeps both fee layers: the original price and the public Prime sale price. Prices are numbers with currency and are per passenger. One credit per successful request.</p>

- **Documentation:** [https://scrappa.co/docs/opodo-api/opodo_flights_search](https://scrappa.co/docs/opodo-api/opodo_flights_search)
- **API group:** Opodo API
- **Endpoint:** `GET https://scrappa.co/api/opodo/flights/search`

## 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 from the locations endpoint, for example BER. |
| `destination` | string | Yes | Destination IATA code from the locations endpoint, for example LHR. |
| `departure_date` | string | Yes | Departure date in YYYY-MM-DD format. |
| `return_date` | string | No | Return date in YYYY-MM-DD format. Adds the return leg when given. |
| `adults` | integer | No | Number of adults, 1 to 9. Defaults to 1. |
| `children` | integer | No | Number of children, 0 to 8. |
| `infants` | integer | No | Number of infants, 0 to 8 and never more than adults. |
| `limit` | integer | No | Offers to return, 1 to 100. Defaults to 25. |

## Example response

```json
{
    "data": {
        "currency": "EUR",
        "trip_type": "one_way",
        "itineraries": [
            {
                "key": "it-1",
                "legs": [],
                "price": {
                    "type": "DISCOUNTED",
                    "amount": 89.99,
                    "currency": "EUR"
                },
                "discount": 40,
                "sections": [],
                "sale_price": {
                    "type": "DISCOUNTED",
                    "amount": 89.99,
                    "currency": "EUR"
                },
                "total_price": 89.99,
                "original_price": {
                    "type": "UNDISCOUNTED",
                    "amount": 129.99,
                    "currency": "EUR"
                },
                "price_per_passenger": 89.99
            }
        ]
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | Opodo data is temporarily unavailable. Please retry. |  |
|  | The upstream response shape changed. |  |
|  | The requested location was not found. |  |

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