---
title: "List activation summaries for all providers on an app"
method: GET
path: "/v1/apps/{id}/providers"
tags: ["Workspace API - Apps"]
---

# List activation summaries for all providers on an app

`GET /v1/apps/{id}/providers`

Returns a lightweight per-provider activation state summary for every provider that has been enabled on the app. Useful for rendering a multi-provider dashboard without N round-trips. For detailed per-step info, call GET /apps/:id/providers/:providerId/activation/steps.

## Path parameters

- `id` string, required

## Response `200`

- ListAppProvidersResponseDto
  - `providers` AppProviderSummaryDto[], required — Activation state summaries for each provider that has been enabled on the app. Providers that have never been touched are not included. For detailed per-step info, call GET /apps/:id/providers/:providerId/activation/steps.
    - `providerId` string, required — Provider identifier
    - `enabled` boolean, required — Whether the provider is enabled on this app
    - `state` 'not_started' | 'in_progress' | 'completed', required — Overall activation state derived from step completion
    - `currentStep` string, required — The type key of the current activation step
    - `currentStepIndex` number, required — Zero-based index of the current step in the step sequence
    - `stepCount` number, required — Total number of steps in this provider's activation sequence
  - `total` number, required — Total number of providers in this response

## Other responses

- `401` — Invalid API key
- `404` — App not found

---

[API](https://skmtc.net/hopae/apis/hconnect-api.md) · [All operations](https://skmtc.net/hopae/apis/hconnect-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hopae/hconnect-api/revisions/ed6e97ac6f2f/schema)