> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt.

# Reception API

The Reception API lets a Reception.ai reseller do in code what the reseller admin panel does by hand: create a workspace for each customer, sell it one of your plans, set up its receptionist, and follow what your card is charged. Every endpoint lives under `https://api.elevenlabs.io/v1/reception` and is available in the Python and TypeScript SDKs as `reception`.

> **Note**
>
> The reseller admin panel, and with it the Reception API, is open to Reception.ai partners only. If
> you're interested in partnering with us, [contact our sales team](https://www.reception.ai/contact-sales).

## Authentication

Create an API key in the reseller admin panel. Only keys created there can call the Reception API; any other ElevenLabs API key is rejected with `not_a_reseller_api_key`. The key is shown once, so store it in a secret manager.

Send the key in the `xi-api-key` header, or set `ELEVENLABS_API_KEY` and let the SDK read it.

## Reseller and workspace endpoints

The API acts at two levels.

| Level     | Acts on                                              | SDK groups                                                                                                                                            |
| --------- | ---------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| Reseller  | Your reseller account                                | `workspaces`, `tiers`, `subscriptions`, `billing`                                                                                                     |
| Workspace | One customer's workspace, named in `xi-workspace-id` | `business_profile`, `receptionists`, `phone_numbers`, `services`, `staff`, `locations`, `holidays`, `products`, `assets`, `knowledge_sources`, `team` |

Workspace endpoints need the `xi-workspace-id` header, set to the ID of a workspace you created. A request without it, or for a workspace that belongs to another reseller, is rejected. In the SDKs the header is the `xi_workspace_id` argument in Python and the `xiWorkspaceId` field in TypeScript.

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

workspaces = elevenlabs.reception.workspaces.list(page_size=50)
for workspace in workspaces.workspaces:
    print(workspace.workspace_id, workspace.business_name, workspace.billing_tier)

staff = elevenlabs.reception.staff.list(
    xi_workspace_id=workspaces.workspaces[0].workspace_id,
)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

const { workspaces } = await elevenlabs.reception.workspaces.list({ pageSize: 50 });
for (const workspace of workspaces) {
  console.log(workspace.workspaceId, workspace.businessName, workspace.billingTier);
}

const staff = await elevenlabs.reception.staff.list({
  xiWorkspaceId: workspaces[0].workspaceId,
});
```

```bash
elevenlabs reception workspaces list --page-size 50
```

## Pagination

`workspaces.list` and `billing.list_invoices` return one page at a time. Pass the `next_cursor` from a response as `cursor` to get the next page, and stop when `has_more` is `false`.

## Rate limits

Limits apply per reseller, across all of its API keys:

| Requests                   | Limit          |
| -------------------------- | -------------- |
| Reads (`GET`)              | 600 per minute |
| Writes (all other methods) | 120 per minute |

A request over the limit returns `429`. Wait and retry it.

## Next steps

* [Quickstart](/docs/reception-ai/reception-api/quickstart): create a customer's workspace and put its receptionist on a phone number.
* [Provisioning and onboarding](/docs/reception-ai/reception-api/provisioning-and-onboarding): examples for creating workspaces in bulk and adding a business's locations, staff, services and receptionist settings.
* [Subscriptions and billing](/docs/reception-ai/reception-api/subscriptions-and-billing): change a customer's plan and see what your card is charged.