APIPhone NumbersGet Phone Number by ID

Get Phone Number by ID

Fetch a single phone number in your organization, with the assigned agent. Returns 404 if the number does not exist in your organization.

Created: September 16, 2026

Updated: September 16, 2026

Overview

GET

https://dashboard.vinsi.ai/api/phone-numbers/{phoneNumberId}

Request

Headers

Content-Type

string

application/json

x-api-key

string

REQUIRED

Params

phoneNumberId

string

OPTIONAL

Example: phn_1757964000123_k2j4h5g6f

Response

{31 items"id":string"phn_1757964000123_k2j4h5g6f"
"phoneNumber":string"+15555550199"
"friendlyName":string"Main Line"
"providerId":string"2468013579246801357"
"provider":string"telnyx"
"capabilities":string"{"voice":true,"sms":true}"
"agentId":string"cmexampleagent000000000001"
"fallbackNumber":null
"isActive":booltrue
"userId":string"cmexampleuser0000000000001"
"organizationId":string"cmexampleorg00000000000001"
"createdAt":string"2026-09-01T18:00:00.000Z"
"updatedAt":string"2026-09-10T21:14:00.000Z"
"SIPUserName":null
"SIPPassword":null
"SIPTerminationURI":null
"livekitTrunkConfigured":booltrue
"trunkName":string"Main Line"
"livekitTrunkId":string"ST_exampleTrunk01"
"livekitOutboundTrunkId":null
"livekitOutboundConfigured":null
"stripeSubscriptionId":null
"routingMode":string"agent"
"routingDeskPhoneId":null
"voicemailEnabled":boolfalse
"voicemailPin":null
"huntGroupId":null
"queueId":null
"queuePriority":null
"livekitCluster":string"vinsi-do"
"agent":{6 items"id":string"cmexampleagent000000000001"
"name":string"Front Desk Agent"
"integrations":null
"isAfterHoursFallback":boolfalse
"routeOutboundVia":string"telnyx"
"defaultOutboundPhoneNumberId":string"phn_1757964000123_k2j4h5g6f"
}
}

Endpoint Explorer

Note: You must be already authenticated on https://dashboard.vinsi.ai/ to use this API tester.

GET

Headers

Content-Type: *

x-api-key: *

Params

phoneNumberId: *

Response

No response yet. Click Send to test the API.