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

# API v1

> Travel API v1 - core flight search and booking

# Travel API v1

The v1 API provides the core functionality for flight search and booking. This is the simplest version and a great starting point for learning how the Travel API works.

## Key Features

* **Flight Search** — Search for flights between cities with date filtering
* **Flight Details** — View detailed information about a flight
* **Simple Booking** — Make a basic flight reservation
* **Booking History** — View your bookings

## Getting Started

The Travel v1 API is accessible at:

```
/api/travel/v1
```

All flights are searched by departure and arrival cities. Use real city names or airport codes to search.

## OpenAPI Specification

The complete API specification is available at `/api/travel/v1/docs` (Swagger UI) or `/api/travel/v1/openapi.json` (OpenAPI spec).

You can:

* **Browse endpoints** — See all available routes and parameters
* **Try requests** — Execute API calls directly from the documentation
* **View schemas** — Understand the request and response structures
* **Check status codes** — Learn what each response means

## Example Use Cases

1. **Search for flights** from one city to another on a specific date
2. **Filter results** by price range, departure time, or airline
3. **Book a flight** and receive a confirmation
4. **View your bookings** to track reservations

## What's Next?

After exploring v1, check out the [v2 API](/scenarios/travel/v2) for more advanced features including authentication, additional booking options, and expanded functionality.