Skip to main content
GET
Get Phone Number Provisioning Usage

Authorizations

Authorization
string
header
default:$CARTESIA_API_KEY
required

Cartesia API key (sk_car_...). Get one at play.cartesia.ai/keys.

Headers

Cartesia-Version
enum<string>
default:2026-08-14
required

API version header.

Available options:
2026-08-14
Example:

"2026-08-14"

Response

200 - application/json

Current monthly phone number provisioning usage.

Cartesia-managed phone number provisioning usage for the current month.

monthly_usage
integer
required

Number of phone numbers provisioned during the current month. This includes active numbers and numbers deleted during the month.

Required range: x >= 0
monthly_limit
integer | null
required

Maximum phone numbers that can be provisioned during the current month. null means the plan has no monthly limit.

Required range: x >= 0
remaining
integer | null
required

Phone numbers that can still be provisioned during the current month. null means the plan has no monthly limit.

Required range: x >= 0