Skip to main content

​
Overview

You must accept the Branded Calling Terms of Service before activating Branded Calling on any enterprise (POST /v2/enterprises/{enterprise_id}/branded_calling); without it, activation returns 403. Read the full terms at telnyx.com/terms/branded-calling. Acceptance is a one-time, idempotent action per user. If Telnyx publishes a new ToS version, you may need to re-accept.

​
API endpoints

MethodPathDescription
GET/v2/terms_of_service/statusCheck whether the current user has agreed to the current ToS for a product.
POST/v2/terms_of_service/branded_calling/agreeAgree to the Branded Calling ToS. No body.
GET/v2/terms_of_service/agreementsList your past agreements (paginated).
GET/v2/terms_of_service/agreements/{agreement_id}Get one specific agreement.
The generic GET /v2/terms_of_service/status, GET /v2/terms_of_service/agreements, and GET /v2/terms_of_service/info endpoints accept a product_type query parameter that defaults to branded_calling.

​
Check your status

curl "https://api.telnyx.com/v2/terms_of_service/status?product_type=branded_calling" \
  -H "Authorization: Bearer YOUR_API_KEY"
Pass product_type=branded_calling. If omitted, it defaults to branded_calling.

​
Accept Branded Calling ToS

curl -X POST https://api.telnyx.com/v2/terms_of_service/branded_calling/agree \
  -H "Authorization: Bearer YOUR_API_KEY"
Idempotent, calling again after you’ve already agreed returns the existing agreement.