# Flightsfrom — 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.

> Discover nonstop flight routes from any airport worldwide by searching locations by name, city, or IATA code, then view detailed daily flight schedules for your chosen routes. Plan your travel efficiently with instant access to all available destinations and their complete flight timetables from any airport.

**Category:** Travel | **Website:** [www.flightsfrom.com/](https://www.flightsfrom.com/) | **Docs:** [parse.bot/marketplace/14af4825-205f-4011-939f-c93914be03d2/flightsfrom-com-api](https://parse.bot/marketplace/14af4825-205f-4011-939f-c93914be03d2/flightsfrom-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-flightsfrom-com-api-14af4825/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_route_schedule

Get the detailed flight schedule for a specific route on a specific date. Returns all individual flights with departure times, airlines, flight numbers, and aircraft types. The origin_iata and destination_iata are composable from list_destinations results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | Yes | Date to retrieve the schedule for, in ISO format YYYY-MM-DD. Must be a current or future date within the schedule window (typically up to ~6 months ahead). |
| `destination_iata` | string | Yes | 3-letter IATA code for the arrival airport (e.g. LAX). Obtainable from list_destinations results. |
| `origin_iata` | string | Yes | 3-letter IATA code for the departure airport (e.g. JFK). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-flightsfrom-com-api-14af4825/get_route_schedule \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","destination_iata":"<string>","origin_iata":"<string>"}'
```

### list_destinations

List all nonstop destinations from a given airport. Returns every direct route with destination details, flight frequency, operating days, duration, and airlines. The returned route_id and destination_iata compose with get_route_schedule for daily timetable lookup.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `airport_iata` | string | Yes | 3-letter IATA airport code (e.g. JFK, LAX, LHR). Obtainable from search_airports results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-flightsfrom-com-api-14af4825/list_destinations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"airport_iata":"<string>"}'
```

### search_airports

Search airports by city name, airport name, or IATA code. Returns matching airports with their IATA codes, location, and number of nonstop routes available. Use the returned IATA codes as input to list_destinations.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search term: city name, airport name, or IATA code (e.g. 'new york', 'heathrow', 'LAX'). Minimum 3 characters recommended for meaningful results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-flightsfrom-com-api-14af4825/search_airports \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```