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

# List providers

`GET /api/providers`

Get a list of all providers, or just those enabled for your client_id.

## Query parameters

- `clientId` string
- `scopes` string[]
- `country` string[]

## Response `200`

Successful response returns a list of providers

- GetProvidersResponse
  - `provider_id` string, required — Unique TrueLayer provider ID
  - `display_name` string, required — Human friendly provider name
  - `logo_url` string, required — URL to the provider’s logo as used by TrueLayer
  - `scopes` 'info' | 'accounts' | 'cards' | 'balance' | 'transactions' | 'direct_debits' | 'standing_orders' | 'offline_access', required — List of Permissions supported by the provider
  - `country` 'de' | 'es' | 'fr' | 'ie' | 'it' | 'lt' | 'pl' | 'uk', required — Country where the provider is available. 2 character [ISO 3166 country code](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)
  - `steps` AuthInputStep[]
    - `type` string, required — Input field type. Can be a Single Choice Input or a Free Input
    - `is_sensitive` boolean — For Free Input Values, is set to true for sensitive information like passwords
    - `values` object[] — For Single Choice Input, an array of values
      - `value` string — For Single Choice Input, input field value
      - `display_name` string — For Single Choice Input, friendly name for this input field value
    - `validations` unknown[] — For Free Input Values, an array of RegEx validation rules that need to be satisfied to consider the input valid
      - unknown
    - `allowed_characters` string — For Free Input Values, character ranges allowed. can be alphanumeric or numeric
    - `id` string, required — Unique id for this field within the method
    - `display_name` string, required — Friendly name for this field within the method
    - `help_text` string, required — Input help text for the end user
    - `mandatory` boolean, required — Indicates whether the field is required

## Other responses

- `500` — Internal Server Error

---

[API](https://skmtc.net/truelayer/apis/authentication-server.md) · [All operations](https://skmtc.net/truelayer/apis/authentication-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/truelayer/authentication-server/revisions/5f6051515b2c/schema)