---
title: "List configured account providers"
method: GET
path: "/accounts/providers"
tags: ["Accounts"]
---

# List configured account providers

`GET /accounts/providers`

## Request

- Base URL: `https://app.openpo.st/api/v1`
- URL: `https://app.openpo.st/api/v1/accounts/providers`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `openpost_session`

## Query parameters

- `workspace_id` string: Workspace ID used to scope operator-installed connectors

## Response `200`

OK

- ProviderInfo[], nullable
  - `auth_mode` string, required: Primary connection method retained for compatibility
  - `capabilities` string[], nullable: High-level OpenPost capabilities available or planned for this provider
  - `configured` boolean, required: Whether this provider can currently be connected
  - `configured_connection_modes` string[], nullable: Connection methods configured and ready on this instance
  - `connection_modes` string[], nullable: Supported distinct connection methods: oauth, app_password, oauth_oob, webhook, or bot
  - `connection_readiness` object: Mode-specific readiness for providers with distinct connection methods
  - `description` string: Short connection or launch note for this provider
  - `display_name` string, required: Human-readable provider name
  - `installation_id` string: Operator installation used for a custom connector
  - `instance_url` string: Federated server URL, when applicable
  - `name` string: Provider app or server display name
  - `platform` string, required: Provider key
  - `readiness` Decision, required
    - `advertisable` boolean, required
    - `analytics_ready` boolean, required
    - `blockers` Blocker[], nullable
      - `code` string, required
      - `detail` string
    - `connectable` boolean, required
    - `contract_digest` string
    - `discoverable` boolean, required
    - `executable` boolean, required
    - `facts` Facts, required
      - `approval` string, required
      - `authorization` string, required
      - `configuration` string, required
      - `control` string, required
      - `live_certification` string, required
      - `local_test` string, required
      - `policy` string, required
    - `observable` boolean, required
    - `publishable` boolean, required
    - `state` string, required
  - `status` string: Provider launch status: available, needs_configuration, or planned

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/openpo/apis/openpost-api.md) · [All operations](https://skmtc.dev/openpo/apis/openpost-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openpo/apis/openpost-api/revisions/67d3964458a7?raw)