> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hopae.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Providers

> Retrieve all provider configurations for an app.

Returns all providers that have been enabled on the specified app, along with their activation state summaries.

## Request

<ParamField header="Authorization" type="string" required>
  `Bearer <API_KEY>` from Console > Developers > Workspace API Keys.
</ParamField>

### Path parameters

<ParamField path="client_id" type="string" required>
  Client identifier of the app.
</ParamField>

## Response

<ResponseField name="providers" type="object[]">
  Activation summary for each provider enabled on the app. Providers that have never been enabled are not included. For detailed per-step progress, call [Get Activation Steps](/api-reference/workspace/activation/get-activation-steps).

  <Expandable title="provider">
    <ResponseField name="providerId" type="string">
      Provider identifier (e.g., `mitid`, `bankidse`, `smartid`).
    </ResponseField>

    <ResponseField name="enabled" type="boolean">
      Whether the provider is enabled on this app.
    </ResponseField>

    <ResponseField name="state" type="string">
      Overall activation state: `not_started`, `in_progress`, or `completed`.
    </ResponseField>

    <ResponseField name="currentStep" type="string">
      Type of the current activation step (e.g., `activation-form`, `activated`).
    </ResponseField>

    <ResponseField name="currentStepIndex" type="number">
      Zero-based index of the current step in the provider's activation sequence.
    </ResponseField>

    <ResponseField name="stepCount" type="number">
      Total number of steps in the provider's activation sequence.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="total" type="number">
  Number of providers returned.
</ResponseField>

<RequestExample>
  ```bash theme={null}
  curl -H "Authorization: Bearer sk_workspace_test_..." \
    "https://sandbox.api.hopae.com/connect/v1/apps/HqTRDIYH/providers"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "providers": [
      {
        "providerId": "mitid",
        "enabled": true,
        "state": "completed",
        "currentStep": "activated",
        "currentStepIndex": 3,
        "stepCount": 4
      },
      {
        "providerId": "bankidse",
        "enabled": true,
        "state": "in_progress",
        "currentStep": "activation-form",
        "currentStepIndex": 1,
        "stepCount": 4
      }
    ],
    "total": 2
  }
  ```
</ResponseExample>