# TopCalls Voice API > AI-powered calling, fully managed. Replace manual dialing. Scale without hiring. First calls live in 2 weeks. ## Docs - [Get account balance](https://docs.topcalls.ai/api-reference/account/get-account-balance.md): Get your account's remaining call minutes and usage information - [Bulk delete leads (hybrid sync/async)](https://docs.topcalls.ai/api-reference/bulk-delete-leads-hybrid-syncasync.md): Delete leads in bulk. Polymorphic body: pass `ids: uuid[]` (max 500, sync only) OR `filter: {list_id?, status?, tag?}` (any size; gateway recounts then auto-routes sync if <=500 / async via job table if >500). - [Bulk import leads](https://docs.topcalls.ai/api-reference/bulk-import-leads.md): Imports up to 2000 leads in a single transaction. `mode='merge'` (default) timestamp-appends notes and DISTINCT-unions tags on existing rows; `mode='skip'` leaves existing rows untouched. Requires scope: `leads:write`. - [Cancel a queued call](https://docs.topcalls.ai/api-reference/calls/cancel-a-queued-call.md): Cancel a call that hasn't started yet - [Create a new call](https://docs.topcalls.ai/api-reference/calls/create-a-new-call.md): Create and dispatch an AI-powered phone call. The call will be queued and executed immediately. - [Get call details](https://docs.topcalls.ai/api-reference/calls/get-call-details.md): Retrieve detailed information about a specific call - [List calls](https://docs.topcalls.ai/api-reference/calls/list-calls.md): Retrieve a paginated list of calls for your account. - [Stop an in-progress call](https://docs.topcalls.ai/api-reference/calls/stop-an-in-progress-call.md): Cancel or stop a call that is currently queued or in progress - [Get campaign details](https://docs.topcalls.ai/api-reference/campaigns/get-campaign-details.md): Retrieve a single campaign by id, scoped to the authenticated account. - [List campaigns](https://docs.topcalls.ai/api-reference/campaigns/list-campaigns.md): List campaigns for your account, ordered by creation time (newest first). - [Pause a campaign](https://docs.topcalls.ai/api-reference/campaigns/pause-a-campaign.md): Mark a campaign as `paused` so the producer stops queuing new calls. In-flight calls are unaffected. - [Start a campaign](https://docs.topcalls.ai/api-reference/campaigns/start-a-campaign.md): Mark a campaign as `running` so the producer / dispatcher workers begin queuing calls. - [List available models](https://docs.topcalls.ai/api-reference/configuration/list-available-models.md): Returns all available AI models grouped by mode. - [List built-in voices](https://docs.topcalls.ai/api-reference/configuration/list-built-in-voices.md): Returns built-in voices grouped by mode and provider. These voices are available without any additional setup. - [List voices](https://docs.topcalls.ai/api-reference/configuration/list-voices.md): Returns available voices for your account, including system voices and any custom/cloned voices. - [Create lead list](https://docs.topcalls.ai/api-reference/create-lead-list.md): Creates a lead list, or returns the existing row matching `(account_id, lower(trim(name)))`. Returns 201 on create, 200 on idempotent re-call. Requires scope: `leads:write`. - [Create or attach lead](https://docs.topcalls.ai/api-reference/create-or-attach-lead.md): Creates a single lead and assigns it to the given list. Idempotent on `(account_id, phone_number)`: if a lead with this phone number already exists in the account, the existing lead is attached to the requested list (no error) and the response carries `existed: true` with HTTP 200. A genuinely new l… - [Delete lead](https://docs.topcalls.ai/api-reference/delete-lead.md): Without `list_id`, hard-deletes the lead row (assignments cascade). With `list_id`, removes only that assignment; if no assignments remain, the lead row is also deleted. Requires scope: `leads:write`. - [Get lead by id](https://docs.topcalls.ai/api-reference/get-lead-by-id.md): Requires scope: `leads:read`. - [API Reference](https://docs.topcalls.ai/api-reference/introduction.md): Complete REST API documentation for TopCalls. Build AI phone agents with our API. - [Create lead list](https://docs.topcalls.ai/api-reference/lead-lists/create-lead-list.md): Create a new lead list, or return the existing one if a list with the same name already exists. - [List lead lists](https://docs.topcalls.ai/api-reference/lead-lists/list-lead-lists.md): Return all lead lists owned by the authenticated account, sorted by name. - [List lead lists](https://docs.topcalls.ai/api-reference/list-lead-lists.md): Returns all lead lists for the account, sorted by name. Requires scope: `leads:read`. - [List leads](https://docs.topcalls.ai/api-reference/list-leads.md): Cursor-paginated list of leads. Requires scope: `leads:read`. - [Add custom carrier](https://docs.topcalls.ai/api-reference/phone-numbers/add-custom-carrier.md): Add a custom SIP carrier (Bring Your Own Carrier). - [Add phone number](https://docs.topcalls.ai/api-reference/phone-numbers/add-phone-number.md): Add a phone number to your account. The number is provisioned in the telephony system. - [Delete custom carrier](https://docs.topcalls.ai/api-reference/phone-numbers/delete-custom-carrier.md): Delete a custom carrier. Cannot delete the TopCalls default carrier. - [Delete phone number](https://docs.topcalls.ai/api-reference/phone-numbers/delete-phone-number.md): Remove a phone number from your account. The number is deprovisioned from the telephony system. - [Get phone number details](https://docs.topcalls.ai/api-reference/phone-numbers/get-phone-number-details.md): Retrieve detailed information about a specific phone number. - [List carriers](https://docs.topcalls.ai/api-reference/phone-numbers/list-carriers.md): Get all custom carriers (BYOC) you've added to your account. - [List phone numbers](https://docs.topcalls.ai/api-reference/phone-numbers/list-phone-numbers.md): Get all phone numbers on your account. - [Update lead](https://docs.topcalls.ai/api-reference/update-lead.md): Requires scope: `leads:write`. Body must contain at least one field; `notes` and `notes_append` are mutually exclusive. - [Create a webhook subscription](https://docs.topcalls.ai/api-reference/webhooks/create-a-webhook-subscription.md): Subscribe a URL to receive events from your account. v1 supports `call.completed` and disposition-suffixed variants like `call.completed.booked_callback`. The `lead.status_changed` and `campaign.activated` / `campaign.paused` event names are reserved for future use. - [Delete a webhook subscription](https://docs.topcalls.ai/api-reference/webhooks/delete-a-webhook-subscription.md): Soft-delete the subscription (sets `deleted_at`). Idempotent - deleting a row that's already soft-deleted also returns 204. Returns 404 for unknown ids or rows belonging to a different account. - [List webhook subscriptions](https://docs.topcalls.ai/api-reference/webhooks/list-webhook-subscriptions.md): List active webhook subscriptions for the authenticated account. Soft-deleted rows are excluded. - [AI & Voice Customization](https://docs.topcalls.ai/concepts/ai-voice.md): Control how your agent sounds, behaves, and responds. Create the perfect AI persona for your use case. - [Campaign Management](https://docs.topcalls.ai/concepts/campaigns.md): Queue management for automated outbound calls. Handle thousands of contacts with timezone awareness, retry logic, and real-time monitoring. - [How TopCalls Works](https://docs.topcalls.ai/concepts/overview.md): Understanding the architecture and capabilities of the TopCalls platform. - [Webhooks & Events](https://docs.topcalls.ai/concepts/webhooks.md): Receive real-time notifications when calls complete, campaigns update, or events occur. Integrate TopCalls with your systems. - [Voice Library & Cloning](https://docs.topcalls.ai/guides/custom-voices.md): Choose from hundreds of built-in voices or clone your own. Create brand-consistent AI agents that sound exactly how you want. - [Function Calling & Tools](https://docs.topcalls.ai/guides/function-calling.md): Give your AI agents tools to interact with your systems during calls. Book appointments, look up orders, update CRMs, and more. - [Knowledge Bases](https://docs.topcalls.ai/guides/knowledge-bases.md): Give your AI agents access to documents, websites, and structured data. Automatically inject relevant context into conversations. - [Making Calls](https://docs.topcalls.ai/guides/making-calls.md): Learn how to make AI phone calls via the TopCalls API. From simple reminders to complex conversations with function calling. - [Webhooks](https://docs.topcalls.ai/guides/webhooks.md): Receive real-time notifications when calls complete, campaigns update, or events occur. Integrate TopCalls with your systems. - [TopCalls Voice API](https://docs.topcalls.ai/index.md): AI-powered calling, fully managed. Replace manual dialing. Scale without hiring. First calls live in 2 weeks. - [Integrations](https://docs.topcalls.ai/integrations.md): Connect Topcalls to your tools to automate the call lifecycle. No code required. - [Quickstart](https://docs.topcalls.ai/quickstart.md): Make your first AI phone call in under 5 minutes. - [Appointment Management](https://docs.topcalls.ai/use-cases/appointment-reminders.md): Automate appointment confirmations, rescheduling, and reminders with AI-powered phone calls. - [Customer Support](https://docs.topcalls.ai/use-cases/customer-support.md): Handle common support inquiries around the clock with AI agents. Escalate complex issues to human agents when needed. - [Compliance & Collections](https://docs.topcalls.ai/use-cases/debt-collection.md): Professional, compliant collection calls with payment plan negotiation and full audit trails. Built-in compliance tooling. - [Lead Qualification & Follow-ups](https://docs.topcalls.ai/use-cases/sales-outreach.md): Qualify inbound and warm leads with AI agents that schedule follow-ups and route qualified prospects to your sales team. For consented contacts only. ## OpenAPI Specs - [openapi](https://docs.topcalls.ai/api-reference/openapi.json) ## Optional - [Website](https://topcalls.ai)