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 Phone Numbers API

Telephony number provisioning and import.

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

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

This API exposes 6 operations across 4 paths, and defines 3 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.

6 operations 4 paths 3 schemas 1 DELETE2 GET1 PATCH2 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 Phone Numbers 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 6

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

Phone Numbers 6

Telephony number provisioning and import.

GET
/phone-numbers
List Phone Numbers
listPhoneNumbers 1 param → 200401
POST
/phone-numbers/import
Import Phone Number
importPhoneNumber 1 param body → 200401422
POST
/phone-numbers/provision
Provision Cartesia Number
provisionPhoneNumber 1 param body → 200401
GET
/phone-numbers/{id}
Get Phone Number
getPhoneNumber 2 params → 200401404
PATCH
/phone-numbers/{id}
Update Phone Number
updatePhoneNumber 2 params body → 200401404
DELETE
/phone-numbers/{id}
Delete Phone Number
deletePhoneNumber 2 params → 200401404

Schemas 3

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

PhoneNumber
object
5 properties
DeleteResponse
object
2 properties
Error
object
6 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

cartesia-ai-phone-numbers-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 Calls API
Cartesia Datasets API
Cartesia Deployments API
Cartesia Infill API
Cartesia Knowledge Base API
Cartesia Metrics API
Cartesia Pronunciation Dictionaries API