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

> Get real-time air and ocean freight rates, search shipping routes, and access logistics service information to compare pricing and plan international shipments. Discover popular routes and retrieve freight rate quotes for any origin-destination pair.

**Category:** Other | **Website:** [flexport.com/](https://flexport.com/) | **Docs:** [parse.bot/marketplace/9ac7d9a8-92ab-4749-bfe4-48b19d6fba11/flexport-com-api](https://parse.bot/marketplace/9ac7d9a8-92ab-4749-bfe4-48b19d6fba11/flexport-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/flexport/`
**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 deferred air rates

Fetch unique 'Deferred' air freight rates for a given origin-destination pair. Returns pricing based on a default 1000kg/6cbm shipment. Origin and destination are airport code slugs (e.g., 'pvg', 'jfk') or city slugs resolved from search_routes. If a city name is provided, it is resolved to a slug via autocomplete before querying rates. Returns an empty rates array when no deferred air service exists for the route.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `destination` | string | Yes | Destination airport code slug or city name (e.g., 'jfk' for JFK Airport, or 'New York' which resolves via autocomplete). |
| `origin` | string | Yes | Origin airport code slug or city name (e.g., 'pvg' for Shanghai Pudong, or 'Shanghai' which resolves via autocomplete). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/flexport/get-deferred-air-rates \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"destination":"<string>","origin":"<string>"}'
```

### Get popular routes

Get the most popular shipping routes from Flexport. Returns route pairs with their available offerings including air, ocean FCL, and ocean LCL rates. Each route includes full pricing breakdowns, transit time estimates, and route node details. No parameters required — returns a fixed set of high-demand trade lanes.

**Estimated cost:** Metered

_No parameters required._

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

### Search routes

Search for airport, seaport, and city location suggestions by keyword. Returns matching locations with their slugs, IATA codes, coordinates, and types. Use the returned slug values as origin/destination inputs to get_deferred_air_rates. A single query may return multiple location types (AIRPORT, SEAPORT, CITY) across different countries.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword for location lookup (e.g., 'Shanghai', 'New York', 'LAX'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/flexport/search-routes \
  -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.