# Flightconnections — 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 flights with detailed information about pricing, schedules, and layover options to find the best travel connections for your trips. Compare multiple flight choices and their costs in one convenient search.

**Category:** Travel | **Website:** [flightconnections.com/](https://flightconnections.com/) | **Docs:** [parse.bot/marketplace/e481b083-93ee-4756-a8b3-17f69fb01ed2/flightconnections-com-api](https://parse.bot/marketplace/e481b083-93ee-4756-a8b3-17f69fb01ed2/flightconnections-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/flightconnections/`
**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 for one-way flights between two airports on a specific date. Returns flight options with up to one connection, filtered by maximum layover duration. Each result includes pricing in USD, airline codes, departure/arrival times (UTC), total duration in seconds, layover details (connecting airport and wait time), and a booking link. Paginates as a single page of up to 50 results after server-side filtering by stopovers and layover ceiling.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | Yes | Date of flight. Accepted formats: 14Nov2026, 2026-11-14, 14/11/2026. |
| `destination` | string | Yes | Destination airport IATA code (3-letter uppercase, e.g. IAH, IAD, ARN). |
| `max_layover_hours` | number | No | Maximum layover duration in hours for flights with one connection. |
| `origin` | string | Yes | Origin airport IATA code (3-letter uppercase, e.g. ARN, IAD, IAH). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/flightconnections/search-flights \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","destination":"<string>","max_layover_hours":"<number>","origin":"<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.