## booking/search-flights

`GET /v1/booking/search-flights`

Flights between two places: each offer's price with its base fare and tax, seats left, and every segment and leg with airports, times, carrier, flight number, cabin and luggage allowance; plus the search's summary (cheapest fare, airlines, stops).

*Booking.com flight search*

| Parameter | Required | Description |
| --- | --- | --- |
| `from` | yes | Departure place code from booking/flight-locations — e.g. `LON.CITY` |
| `to` | yes | Arrival place code from booking/flight-locations — e.g. `LIS.AIRPORT` |
| `depart_date` | yes | Outbound date, YYYY-MM-DD — e.g. `2026-11-25` |
| `return_date` | no | Return date, YYYY-MM-DD, for a round trip |
| `adults` | no | Adults, 1 to 9 — e.g. `1` |
| `children_ages` | no | Children's ages, separated by commas |
| `cabin` | no | economy, premium_economy, business or first — e.g. `economy` |
| `sort` | no | best, cheapest or fastest — e.g. `best` |
| `stops` | no | none, 0, 1 or 2 |
| `page` | no | Page number — e.g. `1` |
| `currency` | no | Three-letter currency code — e.g. `GBP` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. — e.g. `1` |

**Cost:** 3 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/booking/search-flights?from=LON.CITY&to=LIS.AIRPORT&depart_date=2026-11-25" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "adults": 0,
  "atol_protected": "example",
  "count": 0,
  "cursor": null,
  "depart_date": "2026-09-01T12:00:00Z",
  "from": "example",
  "has_more": false,
  "items": [
    {
      "base_fare": {
        "amount": 0,
        "currency": "example"
      },
      "carriers": [
        {}
      ],
      "discount": {
        "amount": 0,
        "currency": "example"
      },
      "fee": {
        "amount": 0,
        "currency": "example"
      },
      "platform": "example",
      "point_of_sale": "example",
      "price": {
        "amount": 0,
        "currency": "example"
      },
      "price_rounded": {
        "amount": 0,
        "currency": "example"
      },
      "segments": [
        {}
      ],
      "tax": {
        "amount": 0,
        "currency": "example"
      },
      "token": "example",
      "trip_type": "example",
      "type": "example"
    }
  ],
  "page": 0,
  "summary": {
    "airlines": [
      {
        "code": "example",
        "count": 0,
        "logo_url": "https://example.com/example",
        "min_price": {},
        "name": "example"
      }
    ],
    "duration_hours": {
      "max": 0,
      "min": 0
    },
    "min_price": {
      "amount": 0,
      "currency": "example"
    },
    "stops": [
      {
        "count": 0,
        "min_price": {},
        "stops": 0
      }
    ]
  },
  "to": "example",
  "total": 0
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/booking/search-flights#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/booking/search-flights.json)