> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flyskye.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API reference

> Every endpoint of the Skye Flights API, with a live playground.

## Base URL

```text theme={"system"}
https://api.flyskye.ai/v1
```

Every request and response is JSON.

## Authentication

> [card] API key
>
> `pk_test_...` or `pk_live_...`. Used only on `POST /token`, and as the bearer for the [MCP server](https://docs.flyskye.ai/mcp.md).

> [card] Access token
>
> `sat_...` from `POST /token`. The bearer on every other call. Lasts an hour.

```bash theme={"system"}
curl https://api.flyskye.ai/v1/bookings/session/5b0c.../payment \
  -H "Authorization: Bearer sat_your_access_token"
```

> [!TIP]
>
> To try an endpoint in the playground, get a token from **Get an access token** with a test key, then paste it into the
> playground's auth field.

## Errors

Every error has one shape. See [Errors](https://docs.flyskye.ai/errors.md) for every code.

```json theme={"system"}
{ "error": { "code": "invalid_request", "message": "departDate cannot be in the past", "field": "departDate" } }
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.