Get Operator

Retrieve full detail for a single operator, including the list of virtual numbers it is assigned to.

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

Returns operator detail with its virtual number assignments.

Requires read permission

Scope

API key scope	Behavior
Account-wide	Can fetch any operator in the account
Project-scoped	Returns `404` for operators not linked to the bound project

Path Parameters

Parameters

Name	Type	Required	Default	Description
`id`	integer	Yes	-	Operator ID

Request

cURL


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

Python


import requests
import os
 
API_KEY = os.environ.get("IDENTITYCALL_API_KEY")
operator_id = 42
 
response = requests.get(
    f"https://api.identitycall.ai/api/v1/public/operators/{operator_id}",
    headers={"Authorization": f"Bearer {API_KEY}"}
)
 
operator = response.json()["data"]
print(f"{operator['name']} — {len(operator['virtual_numbers'])} virtual numbers assigned")
for vn in operator["virtual_numbers"]:
    print(f"  - {vn['phone_number']} ({vn['name']})")

Node.js


const API_KEY = process.env.IDENTITYCALL_API_KEY;
const operatorId = 42;
 
const response = await fetch(
  `https://api.identitycall.ai/api/v1/public/operators/${operatorId}`,
  { headers: { 'Authorization': `Bearer ${API_KEY}` } }
);
 
const { data: operator } = await response.json();
console.log(`${operator.name} — ${operator.virtual_numbers.length} virtual numbers assigned`);
operator.virtual_numbers.forEach(vn => {
  console.log(`  - ${vn.phone_number} (${vn.name})`);
});

Response

Response200 OK

{
"data": {
  "id": 42,
  "name": "Jane Doe",
  "phone_number": "+15551234567",
  "email": "jane.doe@example.com",
  "active": true,
  "initials": "JD",
  "virtual_numbers": [
    {
      "id": 101,
      "phone_number": "+15558675309",
      "name": "Sales line",
      "active": true
    },
    {
      "id": 117,
      "phone_number": "+37060099001",
      "name": "Vilnius support",
      "active": true
    }
  ]
}
}

Response Fields

Field	Type	Description
`id`	integer	Unique operator ID
`name`	string	Full display name
`phone_number`	string	E.164 normalized phone number
`email`	string \| null	Contact email
`active`	boolean	Whether the operator is active
`initials`	string	Two-letter initials derived from `name`
`virtual_numbers`	array	Virtual number assignments (see below)

Each virtual_numbers entry:

Field	Type	Description
`id`	integer	Virtual number ID
`phone_number`	string	Virtual number in E.164
`name`	string	Display name of the virtual number
`active`	boolean	Whether the virtual number is active

Errors

Status	Error	Description
401	”Invalid API key”	Missing or unrecognized bearer token
403	”Read permission required”	API key lacks read permission
404	”Resource not found”	Operator doesn’t exist, or (for project-scoped keys) is not linked to the bound project