# Airfleets — 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 aircraft details and explore airline fleet compositions, including aircraft age, historical data, and new deliveries across global airlines. Track aircraft updates and discover fleet information organized by airline, country, and aircraft type.

**Category:** Travel | **Website:** [airfleets.net/](https://airfleets.net/) | **Docs:** [parse.bot/marketplace/c723778c-430b-4156-8b80-eb74a8565c5d/airfleets-net-api](https://parse.bot/marketplace/c723778c-430b-4156-8b80-eb74a8565c5d/airfleets-net-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/airfleets/`
**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

### Get aircraft details

Retrieve detailed specifications and full operator history for one aircraft identified by type code and MSN. Returns fields such as subtype, first flight date, engine configuration, seat layout, status, and a chronological list of operators with registration changes and delivery dates.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `msn` | string | Yes | Manufacturer serial number (e.g. 3825). |
| `type` | string | Yes | Aircraft type code as used in airfleets URLs (e.g. a320, b737ng, a350, b777). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/airfleets/get-aircraft-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"msn":"<string>","type":"<string>"}'
```

### Get airline fleet

Retrieve full fleet composition for one airline. Returns a breakdown by aircraft type with counts of active, parked, stored/scrapped, historical, and on-order aircraft. Airline name must match the exact spelling used on airfleets.net (use search_airline to discover it).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `airline` | string | Yes | Airline name as used on airfleets.net (e.g. Air France, Lufthansa). Use search_airline to discover exact names. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/airfleets/get-airline-fleet \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"airline":"<string>"}'
```

### Get airline fleet age

Retrieve fleet age statistics for one airline. Returns average age broken down by aircraft type and an overall fleet average age when available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `airline` | string | Yes | Airline name as used on airfleets.net (e.g. Air France). Use search_airline to discover exact names. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/airfleets/get-airline-fleet-age \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"airline":"<string>"}'
```

### Get airline fleet history by type

List individual aircraft of a given type operated by an airline, filtered by status. Returns MSN, subtype, registration, delivery/from date, to date or remarks for each aircraft.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `aircraft_type` | string | Yes | Aircraft type code (e.g. a320, b737ng, a350, b777). |
| `airline` | string | Yes | Airline name as used on airfleets.net (e.g. Air France). |
| `status` | string | No | Status filter: history, active, or stored. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/airfleets/get-airline-fleet-history-by-type \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"aircraft_type":"<string>","airline":"<string>","status":"<string>"}'
```

### Get airlines by country

Browse airlines registered in a specific country with pagination. Each page returns up to 20 airlines. Country name must match the spelling used on airfleets.net (e.g. USA for United States).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | Yes | Country name as used on airfleets.net (e.g. France, USA, Germany, China). |
| `page` | integer | No | Page number (1-based). Each page shows up to 20 airlines. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/airfleets/get-airlines-by-country \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","page":"<integer>"}'
```

### Get last aircraft updates

Retrieve recently modified aircraft records. Returns the latest database updates with aircraft type, MSN, registration, airline, and update date. No input parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/airfleets/get-last-aircraft-updates \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get new aircraft deliveries

Retrieve the latest aircraft deliveries across all manufacturers and airlines. Returns recent delivery records with aircraft type, MSN, registration, receiving airline, and delivery date. No input parameters required; the page always shows the most recent deliveries.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/airfleets/get-new-aircraft-deliveries \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search aircraft

Full-text search for aircraft by registration code or manufacturer serial number (MSN). Returns matching aircraft with type, airline, status, and a URL to their detail page. Results are not paginated; the server returns all matches for the query.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Aircraft registration (e.g. F-GKXS) or MSN (e.g. 3825). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/airfleets/search-aircraft \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### Search airline

Search for airlines by name or partial name. Returns matching airline names with URLs to their fleet pages on airfleets.net. Use this to discover the exact airline name spelling needed by other endpoints.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Airline name or partial name to search (e.g. Lufthansa, Air France). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/airfleets/search-airline \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<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.