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

# Quickstart

> Get started with Unpod using the Dashboard  or API

## Overview

Unpod provides two ways to interact with the platform:

| Method        | Description                                      | Best For                                   |
| ------------- | ------------------------------------------------ | ------------------------------------------ |
| **Dashboard** | Visual interface at [unpod.ai](https://unpod.ai) | Manual setup, configuration, monitoring    |
| **REST API**  | Programmatic access                              | Automation, integrations, custom workflows |

## Understand Core Components

Unpod has 4 core building blocks:

| Component     | Purpose                                               |
| ------------- | ----------------------------------------------------- |
| **Numbers**   | Virtual phone numbers (entry points for calls)        |
| **Providers** | SIP trunking services (LiveKit, Vapi, Twilio)         |
| **Bridges**   | Routing hubs that connect Numbers, Providers & Agents |
| **Agents**    | AI voice agents that handle conversations             |

<Frame>
  <img src="https://mintcdn.com/unpodai/9OLw2S-v9psMSqik/images/diagrams/core-component-data-flow.svg?fit=max&auto=format&n=9OLw2S-v9psMSqik&q=85&s=6904084b61e4173511cf7be08899dc97" alt="Animated core component data flow diagram showing a number routed through a bridge to AI agents, then through a carrier provider to an endpoint." width="1672" height="941" data-path="images/diagrams/core-component-data-flow.svg" />
</Frame>

## API Setup

### Base URL

```
https://unpod.ai/
```

### Authentication

Include this header in all requests:

```http theme={null}
Authorization: Token your-api-token
```

### Required Headers

| Header        | Required       | Description                |
| ------------- | -------------- | -------------------------- |
| Authorization | Yes            | `Token <your-api-token>`   |
| Org-Handle    | Sometimes      | Organization domain handle |
| Product-ID    | Sometimes      | Product identifier         |
| Content-Type  | For POST/PATCH | `application/json`         |

## Quick API Examples

### List All Bridges

```bash theme={null}
curl -X GET "https://unpod.ai/api/v2/platform/telephony/bridges/" \
  -H "Authorization: Token your-api-token" \
  -H "Org-Handle: your-org-handle" \
  -H "Product-ID: your-product-id"
```

### Create a Bridge

```bash theme={null}
curl -X POST "https://unpod.ai/api/v2/platform/telephony/bridges/" \
  -H "Authorization: Token your-api-token" \
  -H "Org-Handle: your-org-handle" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Bridge",
    "description": "Production bridge",
    "region": "IN"
  }'
```

### Get Call Detail Records (CDR)

```bash theme={null}
curl -X GET "https://unpod.ai/api/v2/platform/cdr/" \
  -H "Authorization: Token your-api-token" \
  -H "Org-Handle: your-org-handle"
```

### Get Providers

```bash theme={null}
curl -X GET "https://unpod.ai/api/v2/platform/telephony/providers/" \
  -H "Authorization: Token your-api-token"
```

***

## Next Steps

* [Authentication](/api/get-started/authentication) - Learn about authentication methods
* [Bridges API](/api/telephony/bridges-overview) - Full bridges documentation
* [Numbers API](/api/telephony/numbers) - Manage phone numbers
* [Provider Configurations](/api/provider/overview) - Configure providers

***

## Need Help?

* [Discord Community](https://discord.gg/7kQ4ewNSHZ)
* [YouTube Channel](https://www.youtube.com/@unpod-ai)
* [GitHub](https://github.com/unpod-ai/unpod)