# Skyscanner (India) — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 worldwide and compare prices with autocomplete suggestions for airports and destinations. View price calendars to find the cheapest travel dates and explore real-time flight availability and pricing.

**Category:** Travel | **Website:** [skyscanner.co.in/](https://skyscanner.co.in/) | **Docs:** [parse.bot/marketplace/d41780f4-e213-4f2e-8a1a-650f34d90aaf/skyscanner-co-in-api](https://parse.bot/marketplace/d41780f4-e213-4f2e-8a1a-650f34d90aaf/skyscanner-co-in-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/skyscanner-india/`
**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

### Autocomplete

Autocomplete airport/city name search to get GeoIds (entityIds) and IATA codes for use in other endpoints. Returns matching airports and cities based on the query string. Results include place_id, place_name, city_name, country_name, iata_code, entity_id, and resulting_phrase for each match.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `is_destination` | boolean | No | Whether the search is for a destination airport/city |
| `query` | string | Yes | Search query for airport or city name (e.g. 'London', 'New York', 'Tokyo') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/skyscanner-india/autocomplete \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"is_destination":"<boolean>","query":"<string>"}'
```

### Get price calendar

Retrieve the cheapest available flight prices for a route across a date range. Returns daily prices with price groupings (low/medium/high). The API returns prices starting from the current date regardless of the month specified. Requires origin and destination entity IDs (from autocomplete) plus their IATA codes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `dest_id` | string | Yes | Destination entity ID from the autocomplete endpoint (e.g. '27544008' for London) |
| `dest_sky_id` | string | Yes | IATA code of the destination airport (e.g. 'LHR' for London Heathrow) |
| `month` | string | Yes | Month for the calendar, 1-12 (e.g. '7' for July) |
| `origin_id` | string | Yes | Origin entity ID from the autocomplete endpoint (e.g. '95565050' for London Heathrow) |
| `origin_sky_id` | string | Yes | IATA code of the origin airport (e.g. 'DEL' for Delhi, 'JFK' for New York JFK) |
| `year` | string | Yes | Year for the calendar in YYYY format (e.g. '2026') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/skyscanner-india/get-price-calendar \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"dest_id":"<string>","dest_sky_id":"<string>","month":"<string>","origin_id":"<string>","origin_sky_id":"<string>","year":"<string>"}'
```

### Search flights

Search for one-way or return flights between two airports. Returns up to 20 results sorted by score with pricing and leg details. Requires origin and destination entity IDs from the autocomplete endpoint and a future departure date. Optionally accepts a return date for round-trip searches.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `adults` | integer | No | Number of adult passengers |
| `cabin_class` | string | No | Cabin class for the flight search |
| `departure_date` | string | Yes | Departure date in YYYY-MM-DD format (must be a future date) |
| `dest_id` | string | Yes | Destination entity ID from the autocomplete endpoint (e.g. '95565050' for London Heathrow) |
| `origin_id` | string | Yes | Origin entity ID from the autocomplete endpoint (e.g. '95673498' for New Delhi) |
| `return_date` | string | No | Return date in YYYY-MM-DD format. Omit for one-way flights. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/skyscanner-india/search-flights \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"adults":"<integer>","cabin_class":"<string>","departure_date":"<string>","dest_id":"<string>","origin_id":"<string>","return_date":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.