# Britishairways — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search for British Airways flights between any two airports and filter results by your preferred travel dates and cabin class to find the perfect flight for your trip. Easily compare available options to book your ideal itinerary.

**Category:** Travel | **Website:** [www.britishairways.com/travel/home/public/en_gb/](https://www.britishairways.com/travel/home/public/en_gb/) | **Docs:** [parse.bot/marketplace/f9a0d57e-af69-425d-9f96-5cfc258b2585/britishairways-com-api](https://parse.bot/marketplace/f9a0d57e-af69-425d-9f96-5cfc258b2585/britishairways-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-britishairways-com-api-f9a0d57e/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### search_flights

Search available flights between two airports on a given date. Returns all matching outbound flights with per-flight fare options across cabin sub-classes. Supports round-trip (with return_date) and one-way searches. Each flight includes segment details (times, aircraft, CO2) and multiple fare tiers with pricing. Results are a single page of up to 100 flights for the requested departure date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `adults` | integer | No | Number of adult passengers. |
| `cabin_class` | string | No | Cabin class to search fares for. |
| `departure_date` | string | Yes | Departure date in ISO format YYYY-MM-DD. |
| `destination` | string | Yes | IATA airport code for arrival (e.g. JFK, LAX, CDG). |
| `origin` | string | Yes | IATA airport code for departure (e.g. LHR, CDG, JFK). |
| `return_date` | string | No | Return date in ISO format YYYY-MM-DD. When provided, searches round-trip flights; when omitted, searches one-way. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-britishairways-com-api-f9a0d57e/search_flights \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"adults":"<integer>","cabin_class":"<string>","departure_date":"<string>","destination":"<string>","origin":"<string>","return_date":"<string>"}'
```