---
title: "List Providers"
method: GET
path: "/v1/providers"
tags: ["Providers API"]
---

# List Providers

`GET /v1/providers`

Use this endpoint to list all communication providers configured in the system.

## Query parameters

- `category` 'Email' | 'SMS', required
- `page` integer
- `limit` integer

## Response `200`

The list of all providers configured in the system.

- object
  - `items` ProviderResponse[], required
    - `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.
  - `limit` integer, required
  - `next_cursor` string
  - `page` integer
  - `prev_cursor` string

## Other responses

- `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)