# 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. Each call is automatically billed to your wallet in USDC.

## Access

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

## 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/parse-airfleets-net-api-c723778c/get_aircraft_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-airfleets-net-api-c723778c/get_airline_fleet \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-airfleets-net-api-c723778c/get_airline_fleet_age \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-airfleets-net-api-c723778c/get_airline_fleet_history_by_type \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-airfleets-net-api-c723778c/get_airlines_by_country \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-airfleets-net-api-c723778c/get_last_aircraft_updates \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-airfleets-net-api-c723778c/get_new_aircraft_deliveries \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-airfleets-net-api-c723778c/search_aircraft \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-airfleets-net-api-c723778c/search_airline \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```