---
title: "List providers of the given customer"
method: GET
path: "/providers"
tags: ["Provider"]
---

# List providers of the given customer

`GET /providers`

Returns a list of providers for the authenticated customer.

## Query parameters

- `page_size` integer
- `page_token` string

## Response `200`

A list of providers for the given customer.

- 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` RouteManagerProvider[]
    - `id` string, uuid — The unique identifier of the provider. Returned from the `POST /providers` or `GET /providers` response.
    - `type` 'sip' — Defines the type of the provider. Currently, only 'sip' is supported for VoIP/SIP providers.
    - `hostname` string — The destination hostname for the provider.
    - `tech_prefix` string — The tech prefix, valid only for SIP type providers.
    - `tech_postfix` string — The tech postfix, valid only for SIP type providers.
    - `tech_headers` object — The tech headers, valid only for SIP type providers.
    - `metadata` object, nullable — Carrier-specific resource identifiers stored during automated setup. For Telnyx providers created via `POST /providers/setup`, contains `telnyx_profile_id`, `telnyx_connection_id`, `telnyx_fqdn_id`, and `telnyx_fqdn`. Read-only — populated automatically by the setup endpoint. Empty object `{}` for providers created manually via `POST /providers`.
    - `name` string — The name of the provider.
    - `detail` string — The details about the provider.
    - `codecs` string — Comma-separated codec list offered to this provider (e.g. "PCMU,PCMA"). Empty means server-default negotiation. Applied to outgoing PSTN dial attempts only; has no effect on SIP-to-SIP traffic.
    - `health_status` 'unknown' | 'healthy' | 'unhealthy' — The health status of the provider as determined by periodic SIP OPTIONS probes.
    - `health_checked_at` string, date-time — The timestamp of the last successful health check probe.
    - `tm_create` string, date-time — The creation timestamp.
    - `tm_update` string, date-time — The last update timestamp.
    - `tm_delete` string, date-time — The deletion timestamp.

## Other responses

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

---

[API](https://skmtc.net/voipbin/apis/voipbin-api.md) · [All operations](https://skmtc.net/voipbin/apis/voipbin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voipbin/voipbin-api/revisions/79e779080bcc/schema)