The Get phone number endpoint returns details for a single purchased phone number in your contact center.

Requirements: Base URL, Authentication, Error codes

Scope: numbers.read

What this does

When you send a Get phone number request with a number ID,

When to use it

• Fetch full configuration for a number after listing inventory with Get purchased phone numbers
• Display number details in an admin tool
• Validate whether a number is assigned to a flow or caller ID groups

Prerequisites

• The phone number must exist in your purchased inventory.
• You must have access to the phone number.

Endpoint

GET /api/v4/numbers/{number_id}

Path parameters

• number_id
  The unique identifier of the phone number.

Examples

Minimal request

curl -X GET "https://{cluster_id}.voiso.com/api/v4/numbers/18" \
  -H "Authorization: Bearer <contact_center_api_key>" \
  -H "Content-Type: application/json"

Response

If successful, the API returns a phone number object.

{
  "number": {
    "id": 18,
    "phone_number": "421233056080",
    "label": "Main line",
    "type": "geographic",
    "country": "Slovakia",
    "city": "Bratislava",
    "channels": 4,
    "provider": "Voiso",
    "pricing": {
      "activation_fee": "4.99",
      "monthly_fee": "5.99",
      "partial_month_fee": "3.79",
      "price_per_min": "0.0152"
    },
    "caller_id_groups": [
      {
        "id": 1,
        "name": "Default"
      }
    ],
    "flow": {
      "id": "0b62763c-40d6-4ec8-8380-3cb94e442a75",
      "name": "Lead Qualification"
    },
    "created_at": "2025-11-11T12:00:00.216Z"
  }
}

Notes

• phone_number is returned without a leading plus sign.
• channels is the channel capacity for the phone number.
• pricing values are returned as strings to preserve decimal precision.
• caller_id_groups lists the caller ID groups that include this number.
• flow is included only when the phone number is assigned to a flow.
• This endpoint returns only numbers purchased from
  Voiso
  . It does not include numbers that were added manually.

Troubleshooting

404 Not found

This usually means the number ID does not exist in your purchased inventory, or you do not have access to it.

What to check:

• Confirm the number ID using Get purchased phone numbers.

Example response:

{ "error": "Not found" }