> ## 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.

# Skye Flights API

> Let your AI assistant search and book real flights over REST or MCP. Skye runs checkout, ticketing and refunds as Merchant of Record.

Flights for AI assistants

Your assistant finds the flight. Skye takes the payment, issues the ticket and looks after the traveller until they land.
No booking fee, no markup.

Base URL
`https://api.flyskye.ai/v1`

## Pick your path

> [card] [Quickstart](https://docs.flyskye.ai/quickstart.md)
>
> From an API key to a booked ticket in three calls.

> [card] [MCP server](https://docs.flyskye.ai/mcp.md)
>
> Plug Skye straight into your agent. No token exchange.

> [card] [Skye checkout](https://docs.flyskye.ai/checkout.md)
>
> Hand the user a link. We collect travellers and payment.

> [card] [API reference](https://docs.flyskye.ai/api-reference/introduction.md)
>
> Every endpoint, with a live playground.

## How it fits together

```mermaid actions={false} theme={"system"}
sequenceDiagram
    participant A as Your assistant
    participant S as Skye API
    participant U as Traveller
    A->>S: POST /token (API key)
    S-->>A: access token
    A->>S: POST /search
    S-->>A: live offers
    A->>S: POST /bookings/session (offerId)
    S-->>A: checkoutUrl
    A->>U: Opens checkoutUrl
    U->>S: Adds travellers and pays
    S-->>A: Webhook: booking.ticketed
    S-->>U: E-ticket by email
```

## Products

> [card] [Flights](https://docs.flyskye.ai/search.md)
>
> Live
>
> One way, round trip and multi city. Domestic and international, with live fares.

> [card] [Hotels](https://docs.flyskye.ai/hotels.md)
>
> Coming soon
>
> Search and book stays through the same keys, sessions and checkout.

## Skye is the Merchant of Record

The traveller pays Skye, Skye issues the ticket and handles refunds and airline support. With Skye checkout, card data and
passports never pass through your assistant.

> [card] No booking fee
>
> The traveller pays the airline's fare. Nothing on top.

> [card] Refunds handled
>
> Failed tickets and cancellations go back to the original payment method.

> [card] [Test mode](https://docs.flyskye.ai/test-mode.md)
>
> The whole flow with dummy fares and no real money.

> [!WARNING]
>
> Your API key is a secret. Call the API from your server only, never from a browser or an app bundle.


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