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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/flightsfrom/`
**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 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/credits/flightsfrom/get-route-schedule \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/flightsfrom/list-destinations \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/flightsfrom/search-airports \
  -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.