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

# List Client Workspaces

> Returns all client workspaces with their limits and current usage

Available on agency plans. The API token must belong to the agency owner.

## Query Parameters

| Name                | Type   | Description                                                      |
| ------------------- | ------ | ---------------------------------------------------------------- |
| external\_reference | String | Only return the client workspace with this `external_reference`. |

## Headers

| Name            | Type   | Description        |
| --------------- | ------ | ------------------ |
| Accept\*        | String | application/json   |
| Authorization\* | String | Bearer {api_token} |

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.sitespeak.ai/v1/agency/clients" \
    -H "Accept: application/json" \
    -H "Authorization: Bearer YOUR_API_TOKEN"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.sitespeak.ai/v1/agency/clients', {
    method: 'GET',
    headers: {
      'Accept': 'application/json',
      'Authorization': 'Bearer YOUR_API_TOKEN'
    }
  });

  const data = await response.json();
  console.log(data);
  ```
</RequestExample>

## Response

A `null` limit means no client-level limit is set for that resource.

`usage.messages` counts message credits used in the current cycle, which starts at the beginning of the calendar month or at the client's last credit reset, whichever is later. `messages_remaining` is `null` when no message limit is set.

<Tabs>
  <Tab title="200 Success">
    ```json theme={null}
    {
      "clients": [
        {
          "id": "dfcee2e1-3ace-41c6-9803-fb2b7c7cdfc7",
          "name": "Acme Inc",
          "external_reference": "billing-account-1001",
          "limits": {
            "chatbots": 2,
            "sources": 50,
            "messages": 1000
          },
          "usage": {
            "chatbots": 1,
            "sources": 12,
            "messages": 274
          },
          "messages_remaining": 726,
          "credits_reset_at": null,
          "created_at": "2026-07-22T19:31:40+00:00"
        }
      ]
    }
    ```
  </Tab>

  <Tab title="403 Not an agency account">
    Returns when the API token does not belong to an agency account owner.
  </Tab>
</Tabs>