Get Virtual Number

Retrieve full detail for a single virtual number, including stats, attached operators, and recent calls.

GEThttps://api.identitycall.ai/api/v1/public/virtual_numbers/:id

Returns settings, attached operators, available operators on the account, call statistics, and the 10 most recent calls.

Requires read permission

Scopes

API key scope	Behavior
Account-wide	Can fetch any virtual number on the account.
Project-scoped	Returns 404 if the virtual number is not attached to the key’s project.

Path Parameters

Parameters

Name	Type	Required	Default	Description
`id`	integer	Yes	-	Virtual number ID

Request

cURL


curl -X GET "https://api.identitycall.ai/api/v1/public/virtual_numbers/7" \
  -H "Authorization: Bearer $IDENTITYCALL_API_KEY"

Python


import requests
import os
 
API_KEY = os.environ.get("IDENTITYCALL_API_KEY")
vn_id = 7
 
response = requests.get(
    f"https://api.identitycall.ai/api/v1/public/virtual_numbers/{vn_id}",
    headers={"Authorization": f"Bearer {API_KEY}"}
)
 
vn = response.json()["data"]
print(f"{vn['phone_number']} -> {len(vn['operators'])} operators, routing={vn['routing_strategy']}")

Node.js


const API_KEY = process.env.IDENTITYCALL_API_KEY;
const vnId = 7;
 
const response = await fetch(
  `https://api.identitycall.ai/api/v1/public/virtual_numbers/${vnId}`,
  { headers: { 'Authorization': `Bearer ${API_KEY}` } }
);
 
const { data: vn } = await response.json();
console.log(`${vn.phone_number} -> ${vn.operators.length} operators, routing=${vn.routing_strategy}`);

Response

Response200 OK

{
"data": {
  "id": 7,
  "phone_number": "+15551234567",
  "name": "US Sales Line",
  "country_code": "US",
  "active": true,
  "recording": true,
  "routing_strategy": "priority",
  "ai_receptionist_enabled": false,
  "stats": {
    "total_calls": 142,
    "answered_calls": 118,
    "missed_calls": 24,
    "average_duration_seconds": 184
  },
  "operators": [
    {
      "id": 12,
      "name": "Alice Carter",
      "phone_number": "+15555550112",
      "initials": "AC",
      "priority": 0
    },
    {
      "id": 13,
      "name": "Bob Diaz",
      "phone_number": "+15555550113",
      "initials": "BD",
      "priority": 1
    },
    {
      "id": 14,
      "name": "Carol Evans",
      "phone_number": "+15555550114",
      "initials": "CE",
      "priority": 2
    }
  ],
  "available_operators": [
    {
      "id": 22,
      "name": "Eva Frank",
      "phone_number": "+15555550122",
      "initials": "EF"
    }
  ],
  "recent_calls": [
    {
      "id": 9981,
      "phone_number": "+15558884444",
      "caller_name": "John Smith",
      "call_status": "answered",
      "call_duration": 213,
      "direction": "inbound",
      "ai_handled": false,
      "transcript_summary": null,
      "created_at": "2026-04-14T16:22:05Z"
    }
  ]
}
}

Response Fields

Field	Type	Description
`id`	integer	Unique virtual number ID
`phone_number`	string	E.164 phone number
`name`	string	Display name
`country_code`	string	ISO 3166-1 alpha-2 country code
`active`	boolean	Whether the number receives calls
`recording`	boolean	Whether inbound calls are recorded
`routing_strategy`	string	How calls are distributed across operators (e.g. `priority`, `round_robin`, `simultaneous`)
`ai_receptionist_enabled`	boolean	Whether an AI agent answers inbound calls
`stats`	object	Aggregated call counts and average duration
`operators`	array	Operators attached to this number, ordered by `priority`
`available_operators`	array	Active operators on the account that are NOT yet attached
`recent_calls`	array	Up to 10 most recent calls on this number

Errors

Status	Error	Description
404	”Resource not found”	Virtual number doesn’t exist or isn’t accessible under the key’s scope

Try It

API Key

Parameters

id*

Get Virtual Number

Scopes

Path Parameters

Parameters

Request

cURL

Python

Node.js

Response

Response Fields

Errors

See Also

Try It

Try It