Early access: the dashboard, CLI, MCP server and REST API are available. We are happy to help you set them up for your voice stack.

REST API

Everything over HTTP, for your own dashboards, onboarding flows and automations.

Basics

Base URLhttps://app.trunkbeam.com/v1
AuthAuthorization: Bearer tb_live_…
FormatJSON, timestamps as ISO 8601
Phone numbersE.164, for example +497422944120
Rate limit120 requests per minute per key
SpecificationOpenAPI 3.1 at https://app.trunkbeam.com/v1/openapi.json
curl https://app.trunkbeam.com/v1/numbers \
  -H "Authorization: Bearer $TRUNKBEAM_API_KEY"

Create the key in the dashboard under API, CLI & MCP. Each key has the permissions Read (read), Manage (manage) and Order (order), see Account and verification.

Endpoints

MethodPathPurposePermission
GET/accountAccount, plan, verification status, the key’s permissionsread
GET/pricesPlans and pricesread
GET/verificationVerification status and sitesread
GET/onkz?q=SchrambergSearch an area code by place or coderead
GET/numbersYour numbers with targetread
POST/number-requestsOrder a number (local at a site, or 032)order
GET/number-requestsOrders and their statusread
DELETE/number-requests/{id}Withdraw an open orderorder
POST/numbers/{id}/connectConnect a number to ElevenLabs in one stepmanage
PUT/numbers/{id}/targetRoute a number to a SIP addressmanage
PATCH/numbers/{id}Change agent, label or fallback numbermanage
POST/numbers/{id}/releaseCancel a numberorder
GET/connectionsAgent connections (SIP targets)read
POST/connectionsCreate an agent connectionmanage
PATCH/connections/{id}Change an agent connectionmanage
DELETE/connections/{id}Delete an agent connectionmanage
GET/agent-problemsWhy calls did not reach the agentread
GET/credentialSIP access for outbound calls (without password)read
GET/transfer-policyDefault transfer settingsread
PUT/transfer-policySet default transfer settingsmanage
GET/transfer-policiesDefault and effective rule per numberread
GET, PUT, DELETE/numbers/{id}/transfer-policyA number’s own transfer settingsread / manage
GET/hold-musicHold music with descriptionsread
GET/callsCall log, newest firstread
GET/calls/exportItemized calls as CSVread
GET/usage?month=2026-10Usage and cost for a monthread
GET/usage/dailyCalls and minutes per dayread
GET/usage/exportDaily totals for a month as CSVread
GET, PUT/call-log-settingsCall log settingsread / manage

Only possible in the dashboard: verification and proofs, creating SIP access, plan changes and API keys.

Order a number

Paid actions take two steps, so no script and no AI agent buys by accident. Without confirm you only get a quote:

curl https://app.trunkbeam.com/v1/number-requests \
  -H "Authorization: Bearer $TRUNKBEAM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind": "geographic", "siteId": 3}'
{
  "confirmRequired": true,
  "action": "order_number",
  "monthlyEur": <monthly net price>,
  "message": "Ortsnetznummer im Ortsnetz 07422 für … € netto im Monat …"
}

The same request with "confirm": true places a binding order:

{
  "request": { "id": 41, "kind": "geographic", "status": "fulfilled", "numberE164": "+497422944121" },
  "assigned": { "id": 12, "e164": "+497422944121", "status": "active" }
}

If no number is available right away, assigned is null and the order stays open until we assign the number. For an 032 number, send {"kind": "national032"}. The responses here are shortened; the OpenAPI specification lists all fields.

Errors

{ "error": "Standort ist noch nicht geprüft", "code": "invalid" }
HTTPcodeMeaning
400invalidInput missing or invalid
401unauthorizedKey missing, invalid, expired or revoked
403forbiddenThe key lacks the permission, or the feature is dashboard-only
403org_pendingVerification must be complete before the first number
404not_foundNumber, connection or order does not exist
409invalidNot possible right now, for example number limit reached
429forbiddenMore than 120 requests per minute
Connect your stack to TrunkBeam