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

# Introduction

> The Reached API lets you programmatically manage leads, campaigns, calls, and tasks.

# Welcome to the Reached API

The Reached API is a RESTful API that exchanges JSON over HTTPS. It allows you to programmatically manage your entire outbound calling workflow -- from creating leads and campaigns to retrieving call logs and triggering AI enrichment.

<CardGroup cols={3}>
  <Card title="RESTful" icon="bolt">
    JSON request and response bodies over HTTPS.
  </Card>

  <Card title="API Key Auth" icon="shield-halved">
    Secure Bearer token authentication with scoped API keys.
  </Card>

  <Card title="Rate Limited" icon="clock">
    100 requests per minute per API key with clear rate limit headers.
  </Card>
</CardGroup>

## Base URL

All API requests should be made to:

```
https://kdjmltmhxvvmiuehafgl.supabase.co/functions/v1/api-gateway/v1
```

## What can you do with the API?

| Resource      | Description                                                          |
| ------------- | -------------------------------------------------------------------- |
| **Leads**     | Create, list, get, and update leads in your workspace                |
| **Campaigns** | List campaigns and add leads to them for parallel dialing            |
| **Call Logs** | Retrieve call history with recordings, transcripts, and dispositions |
| **Tasks**     | Create and manage follow-up tasks linked to leads                    |

## Quick Start

<Steps>
  <Step title="Generate an API Key">
    Go to **Settings > API** in the Reached dashboard and create a new API key. Your key will start with `rchd_live_`.
  </Step>

  <Step title="Make your first request">
    ```bash theme={null}
    curl -X GET \
      "https://kdjmltmhxvvmiuehafgl.supabase.co/functions/v1/api-gateway/v1/leads?per_page=5" \
      -H "Authorization: Bearer rchd_live_xxxxxxxxxxxx"
    ```
  </Step>

  <Step title="Check the response">
    ```json theme={null}
    {
      "data": [...],
      "meta": {
        "page": 1,
        "per_page": 5,
        "total": 142
      }
    }
    ```
  </Step>
</Steps>

## Next Steps

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/api-reference/authentification">
    Learn how to authenticate your API requests.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/overview">
    Explore the full endpoint reference.
  </Card>

  <Card title="Clay Integration" icon="plug" href="/tools/clay">
    Push leads from Clay directly into Reached campaigns.
  </Card>

  <Card title="Rate Limiting" icon="gauge-high" href="/rate-limiting">
    Understand request limits and best practices.
  </Card>
</CardGroup>