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

# List the clients

> Every registration of the tenancy.

The registry itself: every registration, each row as [the read](/api-reference/clients/read) answers it. This route reads no query parameter — any query string is `400` `invalid_query`.

## Path parameters

<ParamField path="tenant_id" type="string" required>
  The Tenancy listing.
</ParamField>

## Response

<ResponseField name="clients" type="array" required>
  The registrations: `id`, `tenant_id`, `created_at`, and `label` where one is recorded.
</ResponseField>

<RequestExample>
  ```bash List theme={null}
  curl "https://api.capcells.com/v1/tenants/$TENANT_ID/clients" \
    -H "Authorization: $(capcells_sign "$CAPCELLS_API_KEY" GET "/v1/tenants/$TENANT_ID/clients")"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "clients": [
      {
        "id": "c-0001",
        "tenant_id": "t-0001",
        "label": "contract-0001",
        "created_at": "2026-08-18T22:26:41.410593Z"
      }
    ]
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.