---
title: "Retrieve a Provider"
method: GET
path: "/v1/providers/{id}"
tags: ["Providers API"]
---

# Retrieve a Provider

`GET /v1/providers/{id}`

Use this endpoint to get detailed information about a specific provider using its unique identifier.

## Path parameters

- `id` string, required

## Response `200`

Detailed information about a specific provider.

- ProviderResponse — Information about a communication provider.
  - `id` string — Unique identifier of the provider.
  - `name` string — Name of the provider.
  - `category` 'Email' | 'SMS' — Provider category.
  - `type` 'SendGrid' | 'Twilio' — Provider implementation type.
  - `subType` string — Provider sub-type, if applicable.
  - `method` string — Authentication or delivery method.
  - `clientId` string — Client ID or API key (secret is never returned).
  - `clientId2` string — Secondary client ID, if applicable.
  - `host` string — SMTP or API host address.
  - `port` integer — SMTP port.
  - `disableSsl` boolean — Indicates whether SSL/TLS is disabled.
  - `title` string — Default email or SMS title/subject.
  - `content` string — Default message content template.
  - `receiver` string — Default receiver address for testing.
  - `regionId` string — Cloud region ID (provider-specific).
  - `signName` string — SMS signature name (provider-specific).
  - `templateCode` string — SMS template code (provider-specific).
  - `appId` string — Application ID (provider-specific).
  - `endpoint` string — Provider API endpoint URL.
  - `intranetEndpoint` string — Intranet endpoint for private network access.
  - `domain` string — Provider domain.
  - `providerUrl` string — Provider-specific URL.
  - `createdAt` string, date-time — Timestamp marking when the provider was created.

## Other responses

- `400`
- `404`
- `500`

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/versions/25daba385532/schema)