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

# Reception API

Met de Reception API kan een Reception.ai-reseller in code doen wat het reselleradminpaneel handmatig doet: een workspace maken voor elke klant, deze een van je abonnementen verkopen, de receptionist instellen en bijhouden wat er van je kaart wordt afgeschreven. Elk endpoint staat onder `https://api.elevenlabs.io/v1/reception` en is beschikbaar in de Python- en TypeScript-SDK's als `reception`.

> **Note**
>
> Het reselleradminpaneel, en daarmee de Reception API, is alleen beschikbaar voor Reception.ai-partners. Als
> je geïnteresseerd bent in een samenwerking met ons, [neem dan contact op met ons salesteam](https://www.reception.ai/contact-sales).

## Authenticatie

Maak een API-sleutel in het reselleradminpaneel. Alleen sleutels die daar zijn gemaakt, kunnen de Reception API aanroepen; elke andere ElevenLabs API-sleutel wordt afgewezen met `not_a_reseller_api_key`. De sleutel wordt één keer getoond, dus sla deze op in een secret manager.

Stuur de sleutel mee in de header `xi-api-key`, of stel `ELEVENLABS_API_KEY` in en laat de SDK deze uitlezen.

## Endpoints voor resellers en workspaces

De API werkt op twee niveaus.

| Niveau    | Werkt op                                                   | SDK-groepen                                                                                                                                           |
| --------- | ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| Reseller  | Je reselleraccount                                         | `workspaces`, `tiers`, `subscriptions`, `billing`                                                                                                     |
| Workspace | De workspace van één klant, opgegeven in `xi-workspace-id` | `business_profile`, `receptionists`, `phone_numbers`, `services`, `staff`, `locations`, `holidays`, `products`, `assets`, `knowledge_sources`, `team` |

Workspace-endpoints vereisen de header `xi-workspace-id`, ingesteld op de ID van een workspace die je hebt gemaakt. Een request zonder deze header, of voor een workspace die bij een andere reseller hoort, wordt afgewezen. In de SDK's is de header het argument `xi_workspace_id` in Python en het veld `xiWorkspaceId` 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
```

## Paginering

`workspaces.list` en `billing.list_invoices` retourneren één pagina tegelijk. Geef de `next_cursor` uit een response door als `cursor` om de volgende pagina op te halen, en stop wanneer `has_more` `false` is.

## Ratelimieten

Limieten gelden per reseller, voor alle API-sleutels samen:

| Requests                                  | Limiet         |
| ----------------------------------------- | -------------- |
| Leesbewerkingen (`GET`)                   | 600 per minuut |
| Schrijfbewerkingen (alle andere methoden) | 120 per minuut |

Een request boven de limiet retourneert `429`. Wacht en probeer het opnieuw.

## Volgende stappen

* [Quickstart](/docs/nl/reception-ai/reception-api/quickstart): maak de workspace van een klant en koppel de receptionist aan een telefoonnummer.
* [Provisioning en onboarding](/docs/nl/reception-ai/reception-api/provisioning-and-onboarding): voorbeelden voor het in bulk maken van workspaces en het toevoegen van locaties, personeel, services en receptionistinstellingen van een bedrijf.
* [Abonnementen en facturering](/docs/nl/reception-ai/reception-api/subscriptions-and-billing): wijzig het abonnement van een klant en bekijk wat er van je kaart wordt afgeschreven.