# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/britishairways/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/britishairways/search-flights \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"adults":"<integer>","cabin_class":"<string>","departure_date":"<string>","destination":"<string>","origin":"<string>","return_date":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.