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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-flexport-com-api-9ac7d9a8/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-flexport-com-api-9ac7d9a8/get_deferred_air_rates \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-flexport-com-api-9ac7d9a8/get_popular_routes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-flexport-com-api-9ac7d9a8/search_routes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```