---
title: "List the number providers"
method: GET
path: "/number_providers"
tags: ["NumberProvider"]
---

# List the number providers

`GET /number_providers`

## Request

- Base URL: `https://api.voipbin.net/v1.0`
- URL: `https://api.voipbin.net/v1.0/number_providers`
- Auth: none declared

Returns every number provider the platform supports, with its current setting. A provider that was never changed is listed with its default setting.
The response never contains a secret. `has_secret` tells only whether a secret is stored.
Requires the project super admin permission.

## Response `200`

The list of the number providers. All providers are returned in one response, so `next_page_token` is always empty.

- object
  - `next_page_token` string: Cursor token for the next page of results. Pass this value as the page_token parameter in the next request.
  - `result` NumberManagerNumberProvider[]
    - `provider_name` string: The name of the number provider.
    - `enabled` boolean: Whether the provider takes part in the number purchase.
    - `priority` integer: The purchase order. A lower value is tried first; ties are ordered by `provider_name`.
    - `config` object: The non-secret settings of the provider (for example the Telnyx `connection_id`). Omitted when empty.
    - `has_secret` boolean: Whether a secret is stored through the API. The secret itself is never returned.
    - `key_version` integer: The version of the encryption key that encrypted the stored secret. 0 when no secret is stored.
    - `credential_source` 'db' | 'env' | 'none' | 'db_undecryptable': Where the credentials of the number provider come from. `db` is the secret stored through the API, `env` is the platform environment, `none` means no credential exists, and `db_undecryptable` means a stored secret exists but cannot be decrypted (the provider is unusable until the encryption key is restored or the stored secret is deleted).
    - `usable` boolean: Whether the provider can currently serve (enabled, with a usable credential and its required `config`; Twilio needs `sid` and `trunk_sid`, which the environment credentials cannot give). An enabled and usable provider takes part in number purchase.
    - `updated_by` string, uuid: The agent who last changed `enabled`, `priority` or `config`. The agent ID returned from the `GET /agents` response. Omitted when never changed.
    - `secret_updated_by` string, uuid: The agent who last changed the secret. The agent ID returned from the `GET /agents` response. Omitted when never changed.
    - `tm_update` string, date-time: The timestamp of the last change of the setting, including a secret change. Omitted when never changed.
    - `tm_secret_update` string, date-time: The timestamp of the last secret change. Omitted when never changed.

## Other responses

- `401`: Authentication required (UNAUTHENTICATED).
- `403`: Insufficient permission (PERMISSION_DENIED).
- `500`: Internal error (INTERNAL).

## Changes

- **2026-10-25** `54599fe70445`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/voipbin/apis/voipbin-api/changes/number_providers/get.md)

---

[API](https://skmtc.dev/voipbin/apis/voipbin-api.md) - [All operations](https://skmtc.dev/voipbin/apis/voipbin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/voipbin/apis/voipbin-api/revisions/11338be3ceae?raw)