Virtual Numbers

A virtual number is a phone number you rent through IdentityCall for receiving inbound calls or placing outbound calls. Each virtual number can be assigned to a project and have operators attached so inbound calls are routed to the right humans.

Scopes

API key scope	Allowed operations
Account-wide	List, show, update, purchase, and manage operators on any virtual number
Project-scoped	Same operations restricted to virtual numbers attached to the bound project

Endpoints

List Virtual NumbersGET/virtual_numbers

Every virtual number visible under the key’s scope, with a short operator preview.

Get Virtual NumberGET/virtual_numbers/:id

Full detail with stats, attached operators, available operators, and recent calls.

Update Virtual NumberPATCH/virtual_numbers/:id

Change name, active state, recording flag, or routing strategy.

Search AvailableGET/virtual_numbers/available

Search the inventory of phone numbers available to rent.

Purchase NumberPOST/virtual_numbers/purchase

Rent a number from the available inventory.

Add OperatorPOST/virtual_numbers/:id/add_operator

Attach an existing operator, or auto-create one from a phone number.

Remove OperatorDELETE/virtual_numbers/:id/remove_operator

Detach an operator from a number.

See the OpenAPI spec for the full field list.