# SKY Airline — 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 across SKY Airline routes, explore available airports and travel options, and discover current promotions and brand offerings. Plan your trip efficiently by browsing the airline's complete route network and accessing exclusive deals in one place.

**Category:** Travel | **Website:** [skyairline.com/](https://skyairline.com/) | **Docs:** [parse.bot/marketplace/79ab171e-1410-41b7-98ac-c327f651f13b/skyairline-com-api](https://parse.bot/marketplace/79ab171e-1410-41b7-98ac-c327f651f13b/skyairline-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-skyairline-com-api-79ab171e/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_brand_definitions

Get definitions and included services for each fare brand (Basic, Light, Standard, Max, Max Flex, Full). Each brand lists its products (baggage, seat selection, flexibility) with codes and quantities. Useful for interpreting brandId values returned by search_flights.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `homemarket` | string | No | Market/country code. |
| `language` | string | No | Language code for product descriptions. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-skyairline-com-api-79ab171e/get_brand_definitions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"homemarket":"<string>","language":"<string>"}'
```

### get_promotions

Retrieve promotional content, banners, campaign details, and quick-access links from the SKY Airline home page CMS. Returns structured sections: caluga (promotional cards with prices), huincha (alert banners), benefits (deals), experience (discover SKY), search_box (hero banner), and quick_accesses (check-in, my trips, flight status links).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `homemarket` | string | No | Market name for CMS content targeting. |
| `locale` | string | No | Locale code for content language. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-skyairline-com-api-79ab171e/get_promotions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"homemarket":"<string>","locale":"<string>"}'
```

### list_airports

List all airports served by SKY Airline. Returns IATA codes, city names, coordinates, country, and zone classification. The full network is returned in a single response (no pagination). Results vary by homemarket — some markets see a subset of the network.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `homemarket` | string | No | Market/country code that scopes the visible airport set. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-skyairline-com-api-79ab171e/list_airports \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"homemarket":"<string>"}'
```

### list_routes

List valid flight routes (origin-to-destination mappings) served by SKY Airline. Each route object contains an origin IATA code and an array of destination IATA codes reachable from it. The full route map is returned in a single response.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `homemarket` | string | No | Market/country code that scopes the visible route set. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-skyairline-com-api-79ab171e/list_routes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"homemarket":"<string>"}'
```

### search_flights

Search for available flights by origin, destination, and dates. Returns flight options with segments (timing, equipment, cabin class), fares across all brands (Basic, Light, Standard, Max, Max Flex, Full), and seat availability. Supports one-way and round-trip searches. Departure date must be in the future.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `adults` | integer | No | Number of adult passengers (1-9). |
| `children` | integer | No | Number of child passengers (0-9). |
| `departure_date` | string | Yes | Departure date in YYYY-MM-DD format. Must be a future date. |
| `destination` | string | Yes | Destination airport IATA code (e.g., CCP, ARI). Obtain valid codes from list_airports or list_routes. |
| `homemarket` | string | No | Market/country code that determines currency and pricing. |
| `infants` | integer | No | Number of infant passengers (0-9). |
| `origin` | string | Yes | Origin airport IATA code (e.g., SCL, LIM, ARI). Obtain valid codes from list_airports. |
| `return_date` | string | No | Return date in YYYY-MM-DD format for round trips. Must be after departure_date. Omit for one-way. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-skyairline-com-api-79ab171e/search_flights \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"adults":"<integer>","children":"<integer>","departure_date":"<string>","destination":"<string>","homemarket":"<string>","infants":"<integer>","origin":"<string>","return_date":"<string>"}'
```