---
title: "Get provider by ID"
method: GET
path: "/providers/{id}"
tags: ["Provider"]
---

# Get provider by ID

`GET /providers/{id}`

Retrieves the provider details for the specified ID.

## Path parameters

- `id` string, required

## Response `200`

The details of the provider with the specified ID.

- 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

- `400` — Invalid request (INVALID_ARGUMENT).
- `401` — Authentication required (UNAUTHENTICATED).
- `403` — Insufficient permission (PERMISSION_DENIED).
- `404` — Resource not found (NOT_FOUND).
- `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/versions/79e779080bcc/schema)