# United — 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 United Airlines flights, check real-time flight status, and view detailed seat maps to plan your perfect trip. Compare fare options and use airport autocomplete to quickly find your departure and arrival cities.

**Category:** Travel | **Website:** [united.com/](https://united.com/) | **Docs:** [parse.bot/marketplace/780bf9fc-f95b-4b07-b1a8-2b2e8ba7d02a/united-com-api](https://parse.bot/marketplace/780bf9fc-f95b-4b07-b1a8-2b2e8ba7d02a/united-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-united-com-api-780bf9fc/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_fare_options

Get available fare options for a selected flight. Requires a valid cart_id and flight_hash from a recent search_flights response. The server-side search session must still be active (typically a few minutes after search) for detailed fare quotes; an expired session returns Status 0 with an error array.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `cart_id` | string | Yes | Cart ID from search_flights response (cart_id field) |
| `flight_hash` | string | Yes | Flight hash from search_flights response (hash field in flights array) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-united-com-api-780bf9fc/get_fare_options \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cart_id":"<string>","flight_hash":"<string>"}'
```

### get_flight_status

Get real-time flight status for a United Airlines flight by flight number and date. Returns departure/arrival times (scheduled and actual), gates, terminals, equipment info, delay information, weather data, and current operational status. Date must be within approximately 2 days of today.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | Yes | Flight date in YYYY-MM-DD format (must be within approximately +/- 2 days of today) |
| `flight_number` | string | Yes | UA flight number (e.g. 1960, 2115) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-united-com-api-780bf9fc/get_flight_status \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","flight_number":"<string>"}'
```

### get_seat_map

Retrieve the seat map for a specific United Airlines flight. Returns cabin layouts with seat-level availability, attributes (window, aisle, exit row, bulkhead), recline type, and cabin branding. The departure_time parameter should match the actual flight schedule for accurate results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `departure_date` | string | Yes | Departure date in YYYY-MM-DD format |
| `departure_time` | string | No | Departure time in HH:mm format matching the actual flight schedule (e.g. 07:00) |
| `destination` | string | Yes | Destination airport IATA code (e.g. SFO) |
| `flight_number` | string | Yes | UA flight number (e.g. 1960) |
| `origin` | string | Yes | Origin airport IATA code (e.g. EWR) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-united-com-api-780bf9fc/get_seat_map \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"departure_date":"<string>","departure_time":"<string>","destination":"<string>","flight_number":"<string>","origin":"<string>"}'
```

### search_airport_autocomplete

Autocomplete airport search by city name or airport code. Returns matching airports with IATA codes, city, country, and state information. Useful as the first step to resolve human-readable city names into machine-readable IATA codes for flight search.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search query (city name or airport IATA code, e.g. Chicago, EWR, London) |

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

### search_flights

Search for available United Airlines flights between two airports. Returns a cart_id for session continuity, a list of flight options with per-cabin pricing, and fare family metadata. Each flight option includes a hash identifier for downstream fare selection via get_fare_options. All results arrive in one response (no pagination needed).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `book_with_miles` | boolean | No | Search for award travel with miles |
| `cabin_class` | string | No | Cabin class preference |
| `departure_date` | string | Yes | Departure date in YYYY-MM-DD format |
| `destination` | string | Yes | Destination airport IATA code (e.g. SFO, JFK, ORD) |
| `flexible_dates` | boolean | No | Search for refundable fares only |
| `num_adults` | integer | No | Number of adult passengers |
| `origin` | string | Yes | Origin airport IATA code (e.g. EWR, LAX, ORD) |
| `return_date` | string | No | Return date in YYYY-MM-DD format, required when trip_type is 2 |
| `trip_type` | integer | No | 1 for one-way, 2 for roundtrip |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-united-com-api-780bf9fc/search_flights \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"book_with_miles":"<boolean>","cabin_class":"<string>","departure_date":"<string>","destination":"<string>","flexible_dates":"<boolean>","num_adults":"<integer>","origin":"<string>","return_date":"<string>","trip_type":"<integer>"}'
```