Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Cartesia Calls API

Outbound call placement, batching, and history.

Cartesia Calls API is one of 21 APIs that Cartesia publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Calls. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 12 operations across 10 paths, and defines 4 schemas. It is described by OpenAPI 3.0.3, at version 2026-03-01.

Requests are made against a single base URL, https://api.cartesia.ai.

12 operations 10 paths 4 schemas 1 DELETE6 GET5 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
2026-03-01
Base URL
https://api.cartesia.ai
Authentication
HTTP Bearer
Contact
Resource Areas
1

Authentication & Security 1

Cartesia Calls API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (sk_car_... API key or short-lived access token) (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — Cartesia API key (skcar...) or a short-lived access token minted via POST /access-token, passed as Authorization: Bearer . Every request also requires the Cart…

Paths & Operations 12

Across 10 paths, the API surfaces 12 operations — 1 DELETE, 6 GET, 5 POST. Each is listed below with its method, path, parameters, and response codes.

Calls 12

Outbound call placement, batching, and history.

GET
/calls
List Calls
listCalls 1 param → 200401
POST
/calls/outbound
Create Outbound Call
createOutboundCall 1 param body → 200401422
GET
/calls/{id}
Get Call
getCall 2 params → 200401404
DELETE
/calls/{id}
Delete Call
deleteCall 2 params → 200401404
POST
/calls/{id}/cancel
Cancel Call
cancelCall 2 params → 200401404
GET
/calls/{id}/audio
Download Call Audio
downloadCallAudio 2 params → 200401404
GET
/calls/{id}/logs
Get Call Runtime Logs
getCallLogs 2 params → 200401404
GET
/call-batches
List Call Batches
listCallBatches 1 param → 200401
POST
/call-batches
Create Call Batch
createCallBatch 1 param body → 200401422
GET
/call-batches/{id}
Get Call Batch
getCallBatch 2 params → 200401404
POST
/call-batches/{id}/cancel
Cancel Call Batch
cancelCallBatch 2 params → 200401404
POST
/call-batches/{id}/retry
Retry Call Batch
retryCallBatch 2 params → 200401404

Schemas 4

The contract defines 4 schemas that model the data the API accepts and returns. The most detailed are CallBatch (7 properties), Call (7 properties), Error (6 properties), DeleteResponse (2 properties). Each schema is shown below with its type and property counts.

DeleteResponse
object
2 properties
Call
object
7 properties
Error
object
6 properties
CallBatch
object
7 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

cartesia-ai-calls-api-openapi.yml Raw ↑

Other APIs Cartesia publishes across the network.

Cartesia TTS WebSocket API
Cartesia STT WebSocket API
Cartesia Agents API
Cartesia API Keys API
Cartesia Auth API
Cartesia Datasets API
Cartesia Deployments API
Cartesia Infill API
Cartesia Knowledge Base API
Cartesia Metrics API
Cartesia Phone Numbers API
Cartesia Pronunciation Dictionaries API