# Turkishairlines — 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 Turkish Airlines flights and airport locations, then check real-time flight status to stay updated on your travel plans. Browse available flights to find the best options for your journey, though availability searches may occasionally experience interruptions due to site protection measures.

**Category:** Travel | **Website:** [www.turkishairlines.com/](https://www.turkishairlines.com/) | **Docs:** [parse.bot/marketplace/e629fc7b-4e2e-439c-aaa2-dc127735d520/turkishairlines-com-api](https://parse.bot/marketplace/e629fc7b-4e2e-439c-aaa2-dc127735d520/turkishairlines-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/turkishairlines/`
**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 flight status

Get the current status of a Turkish Airlines flight by flight number and date. Returns departure/arrival times, airports, aircraft type, terminals, gates, and distance. Strips 'TK' prefix automatically if provided. Returns has_flights=false when no flights operate on the given date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Flight date in YYYY-MM-DD format. Defaults to today's date (UTC). |
| `flight_number` | string | Yes | Turkish Airlines flight number (e.g., '2', 'TK2', '188', 'TK188') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/turkishairlines/get-flight-status \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","flight_number":"<string>"}'
```

### Search flights

Search for flight availability and prices between two airports. Supports one-way and round-trip searches with passenger and cabin class options. Returns legs with detailed fare breakdowns per flight option, including brand rights (baggage, reissue, refund policies). Prices are in TRY. Each leg contains multiple flight options sorted by departure time.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `adults` | integer | No | Number of adult passengers |
| `cabin_class` | string | No | Cabin class for the search. |
| `children` | integer | No | Number of child passengers |
| `departure_date` | string | Yes | Departure date in YYYY-MM-DD format |
| `destination` | string | Yes | Destination airport code (e.g., 'JFK', 'IST', 'CDG') |
| `infants` | integer | No | Number of infant passengers |
| `origin` | string | Yes | Origin airport code (e.g., 'IST', 'JFK', 'LHR') |
| `return_date` | string | No | Return date in YYYY-MM-DD format. Omit for one-way search. |

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

### Search locations

Search for airports and cities served by Turkish Airlines. Returns airport codes, city names, countries, and whether multi-port selections are available. Query matches against airport and city names. A single city may resolve to multiple ports (e.g. Istanbul → IST + SAW).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search text for airport or city name (e.g., 'London', 'Istanbul', 'JFK') |

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