Skip to Content
CallMitraDocs
API referencePhone numbers

List phone numbers

Every number in your workspace with its carrier, call capacity and the agent using it. Credentials are never returned, only whether each one is saved.

GET
/api/v1/phone-numbers/

Every number in your workspace with its carrier, call capacity and the agent using it. Credentials are never returned, only whether each one is saved.

Authorization

headerX-API-Key<token>

Create in the console: Settings → API & webhooks.

Response Body

OK

application/json
  1. response

Every phone number in the workspace, newest first.

phoneNumbers*array<>

Numbers, newest first.

success?Success

Always true on a 2xx response.

Defaulttrue
[key: string]?any
Example Request
curl -X GET 'https://api.callmitra.ai/api/v1/phone-numbers/'
Example Response
{  "phoneNumbers": [    {      "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}