> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.etera.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.etera.dev/_mcp/server.

# ETERA API Documentation

![ETERA](/_fern-files/docs.etera.dev/ab99e3c97a06fd781da40a6255ce7bba0427416da0241ce684d4b056fa7a6257/assets/etera-logo.png)

## Build with ETERA

ETERA powers travel and lifestyle applications with a unified API platform. Search, book, and manage travel experiences through a single consistent interface.

#### 525+ Endpoints

Comprehensive coverage across all travel verticals

#### 4 Verticals

Restaurant, Experience, Hotel, and Flight

#### 26 Microservices

Purpose-built services with consistent patterns

#### 3 Environments

Production, Staging, and Development

---

## Quick Start

Get up and running in under 5 minutes:

#### Get your API key

Sign up at the [ETERA Dashboard](https://dashboard.etera.dev/api-keys) and generate an API key.

#### Make your first request

**`cURL`**

```bash title="cURL"
curl https://api.etera.dev/restaurant/search/recommendations/ \
  -H "Authorization: Bearer YOUR_API_KEY"
```

**`TypeScript`**

```typescript title="TypeScript"
const restaurants = await fetch(
  "https://api.etera.dev/restaurant/search/recommendations/",
  { headers: { Authorization: "Bearer YOUR_API_KEY" } }
).then(res => res.json());
```

**`Python`**

```python title="Python"
import requests

restaurants = requests.get(
    "https://api.etera.dev/restaurant/search/recommendations/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
).json()
```

#### Explore the API

Browse the reference tabs above to discover endpoints across all verticals.

---

## Travel Verticals

#### [Restaurant](/restaurant)

Search 1M+ restaurants, manage bookings and reservations, AI-powered dining agents, and MCP tool integration for smart recommendations

#### [Experience](/experience)

Discover activities in 120+ destinations, book experiences instantly, search with AI recommendations, and manage experience catalogs

#### [Hotels](/hotels)

Search 4M+ stays with hybrid/vector/text modes, manage booking lifecycles, property data management, and AI-powered hotel agents

#### [Flights](/flights)

Search 400+ carriers globally, pricing with fare options, airline data, booking lifecycle management, and AI-powered flight agents

## Platform Services

#### [Authentication](/platform)

Phone OTP, email OTP, Google & Apple OAuth with JWT tokens

#### [Account](/platform)

User profiles, avatars, settings, likes, and booking history

#### [Payments](/platform)

Stripe-based payment processing, refunds, and customer management

#### [AI Supervisor](/platform)

AI-powered agent coordination, intent detection, and conversation management

---

## Consistent Architecture

Every travel vertical follows the same 5-service architecture:

| Service      | Purpose                      | Example Endpoint                          |
| ------------ | ---------------------------- | ----------------------------------------- |
|  **Search**  | Discovery & recommendations  | `GET /restaurant/search/recommendations/` |
|  **Booking** | Reservation lifecycle        | `POST /hotel/booking/bookings/`           |
|  **Data**    | Content & catalog management | `GET /flight/data/airlines/`              |
|  **MCP**     | Model Context Protocol tools | `GET /experience/mcp/mcp/tools`           |
|  **Agent**   | AI-powered automation        | `POST /restaurant/agent/ai-input`         |

> **Info**
>
> All endpoints follow the pattern: `https://api.etera.dev/{vertical}/{service}/{endpoint}`

---

## Guides

#### [Getting Started](/guides/getting-started)

Make your first API call in under 5 minutes

#### [Authentication](/guides/authentication)

Set up phone OTP, email, or OAuth authentication

#### [MCP Integration](/guides/mcp-integration)

Connect AI models to ETERA via Model Context Protocol

#### [SDKs & Examples](/guides/sdks)

TypeScript, Python, and cURL code examples