# API Overview (/docs/api/introduction/overview)

> For the complete documentation index, see [llms.txt](https://docs.tandemcx.ai/llms.txt). Any page on this site can be fetched as Markdown by appending `.md` to its URL.

The Tandem API lets you build on the platform programmatically: manage workflows,
media, integrations, phone numbers, and messaging directly from your own services.

## Base URL

All requests are made over HTTPS to the base URL for your environment:

<ApiBaseUrl />

The API answers at both `api.tandemcx.ai` and `api.spark.sharpencx.com` (in development,
`api.develop.tandemcx.ai` and `api.develop.spark.sharpencx.com`). Both hosts serve the same API
and accept the same tokens, so you can use either.

## Request and response format

Requests and responses use JSON. Send `Content-Type: application/json` on any
request with a body. Responses are JSON unless otherwise noted (for example,
audio downloads return binary data).

## Resources

The API is organized into resource groups. The **Reference** column says which ones have
endpoint-by-endpoint documentation in this portal, generated from the service's own OpenAPI
spec.

| Resource              | Base path                   | Reference                                                   |
| --------------------- | --------------------------- | ----------------------------------------------------------- |
| Voice agents          | `/v1/agent-media`           | [Voice Agents](/docs/api/voice-agents/agents/listAgents)    |
| Prompts (media)       | `/v1/media/prompts`         | [Media](/docs/api/media/prompts/listPrompts)                |
| Text-to-speech        | `/v1/media/tts`             | [Media](/docs/api/media/prompts/listPrompts)                |
| Phone numbers         | `/v1/routing/phone-numbers` | [Routing](/docs/api/routing/phone-numbers/listPhoneNumbers) |
| Billing               | `/v1/billing`               | [Billing](/docs/api/billing/billing/getBalance)             |
| Contacts              | `/v1/contacts`              | [Contacts](/docs/api/contacts/contacts/listContacts)        |
| Workflows             | `/v1/workflows`             | Not yet documented                                          |
| Integrations          | `/v1/integrations`          | Not yet documented                                          |
| Knowledge bases       | `/v1/knowledge`             | Not yet documented                                          |
| Email                 | `/v1/email`                 | Not yet documented                                          |
| Reporting             | `/v1/reporting`             | Not yet documented                                          |
| Audit log             | `/v1/audit`                 | Not yet documented                                          |
| Users                 | `/v1/accounts`              | Not yet documented                                          |
| Secrets and variables | `/v1/org-config`            | Not yet documented                                          |
| SIP trunks            | `/v1/routing/sip-trunks`    | Not yet documented                                          |
| Organization settings | `/v1/settings`              | Not yet documented                                          |

A group marked "not yet documented" is a live part of the API; it has no generated reference
here yet. Contact support if you need its shapes before it lands.

## Next steps

- [Authentication](/docs/api/introduction/authentication) — how to authorize requests.
- [Pagination](/docs/api/introduction/pagination) — how to page through list endpoints.
- [Error Handling](/docs/api/introduction/error-handling) — the error format and status codes.