---
title: "List credential pools for a workspace"
method: GET
path: "/api/v1/credentials/"
tags: ["credentials"]
---

# List credential pools for a workspace

`GET /api/v1/credentials/`

Retrieve a list of credential pools belonging to a specific workspace.
Each credential pool summary includes the pool ID, total number of credentials, number of available (unredeemed) credentials, and the workspace ID.

## Query parameters

- `workspace_id` string, required

## Headers

- `Authorization` string, required

## Response `200`

Credential pools retrieved successfully

- CredentialsListCredentialPoolsResponse200
  - `credential_pools` ApiV1CredentialsGetResponsesContentApplicationJsonSchemaCredentialPoolsItems[]
    - `credential_pool_id` string — The unique identifier for the credential pool
    - `total_credentials` integer — Total number of credentials in the pool
    - `available_credentials` integer — Number of unredeemed credentials available

## Other responses

- `400` — Error
- `403` — Forbidden - User does not have workspace.workspace_update permission
- `502` — Bad Gateway - Credentials service unavailable or internal error

---

[API](https://skmtc.net/prolific/apis/api-reference.md) · [All operations](https://skmtc.net/prolific/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prolific/api-reference/versions/dc6f073a9827/schema)