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

# Home

> A ready-made, well-designed REST API for learning and testing

# Take-Home API

A ready-made, well-designed REST API mimicking many real-world scenarios.

Each scenario models a realistic business domain — airline booking, e-commerce, food delivery, and more — fully implemented and served out of the box. No backend to design, no server to write. Just a real API with a friendly, well-documented flow, ready to run.

## Why Take-Home API?

Most coding challenge and system design tools ask you to build a backend from scratch. This one flips that: **the API already exists, fully working, and you learn by using it**. That's a closer match to real engineering work — consuming an API you didn't design, understanding its data model, and building something on top of it.

## What You Can Do

1. **Build a frontend** against a well-modeled, realistic API
2. **Learn how a REST API works** by following real use-case flows
3. **Write integration tests** against a live, realistic target
4. **Take home assessments** — explore the API and see how you'd use it
5. **AI agent integration** — use the provided MCP server for your AI workflows

## Scenarios

Each scenario is a self-contained API namespace, versioned by the complexity and breadth of features:

* **v1** → core happy path
* **v2** → expanded use cases, authentication, and more endpoints

Start with v1 to learn the basics, then move to v2 to explore more complex flows and authentication patterns.

## Getting Started

Browse the [Travel](/scenarios/travel) scenario to see examples of the API in action. You can explore the OpenAPI specification for each API version and try endpoints directly.