API referencePhone numbers
Get a phone number
One number with its carrier, call capacity and the agent using it.
GET
One number with its carrier, call capacity and the agent using it.
header
X-API-Key<token>Create in the console: Settings → API & webhooks.
phone_id*Phone IdThe number's id from GET /phone-numbers.
OK
application/json- response
One phone number.
phoneNumber*The number.
success?SuccessAlways true on a 2xx response.
Default
true[key: string]?anycurl -X GET 'https://api.callmitra.ai/api/v1/phone-numbers/string'Example Response
{ "phoneNumber": { "assignedAgentId": "4f6d2c1a-9b7e-4c3d-8a21-5e0f7b9c1d23", "assignedAgentName": "Priya - Sales", "e164": "+918065522999", "id": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d", "inboundAgentId": "4f6d2c1a-9b7e-4c3d-8a21-5e0f7b9c1d23", "label": "Main line", "lastSyncedAt": "2026-01-15T09:30:00+00:00", "maxConcurrentCalls": 50, "metadata": {}, "name": "Main line", "number": "+918065522999", "plivoAuthTokenSet": true, "provider": "plivo", "providerResourceId": "MAXXXXXXXXXXXXXXXXXX", "sipDomain": "", "sipOutboundProxy": "", "sipPasswordSet": false, "sipUsername": "", "twilioAccountSid": "", "twilioAuthTokenSet": false, "vobizAuthTokenSet": false }, "success": true}Update a lead PUT
Changes only the fields you send. Send `If-Match` with the lead's `updatedAt` to refuse the write (`lead_changed`) when someone changed the lead after you read it. A new `phone` is stored in E.164 form like on create. Campaign IDs you cannot access are skipped.
Get a SIP trunk GET
One SIP trunk with its settings, sync status and numbers. The password is never returned.