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

# GET /v1/sender-pools — Inspect Delivery Sender Pools

> GET /v1/sender-pools — Returns private delivery pools for your workspace, including daily capacity and remaining send volume for the current period.

Use this endpoint to inspect the private delivery pools assigned to your workspace. A sender pool groups one or more sender accounts together to distribute outbound volume across them. You can use pool data to monitor daily capacity and decide whether to throttle or accelerate campaign send rates before queuing new work.

```bash theme={null}
GET /v1/sender-pools
```

## Authorization

All requests must include a Bearer token in the `Authorization` header. You can find your API key in the Leadterra dashboard under **Settings → API Keys**.

## Request Parameters

This endpoint accepts no query parameters, path parameters, or request body.

## Example Request

```bash theme={null}
curl --request GET \
  --url https://app.leadterra.co/v1/sender-pools \
  --header "Authorization: Bearer sk_live_YOUR_KEY" \
  --header "Content-Type: application/json"
```

## Response Fields

The response is a JSON array. Each element represents one sender pool belonging to your workspace.

<ResponseField name="id" type="string">
  Unique identifier for the pool (e.g., `pool_01HABC`).
</ResponseField>

<ResponseField name="name" type="string">
  Human-readable label assigned to the pool in the Leadterra dashboard.
</ResponseField>

<ResponseField name="dailyCapacity" type="integer">
  Maximum number of emails this pool can send within a 24-hour rolling window.
</ResponseField>

<ResponseField name="remainingVolume" type="integer">
  Number of emails still available to send within the current 24-hour window. Resets at the start of each period.
</ResponseField>

<ResponseField name="senderAccountIds" type="array of strings">
  List of sender account IDs that belong to this pool. Use the [Sender Accounts](/api-reference/sender-accounts) endpoint to look up details for each ID.
</ResponseField>

## Example Response

```json theme={null}
[
  {
    "id": "pool_01HABC123",
    "name": "Primary Outbound Pool",
    "dailyCapacity": 2000,
    "remainingVolume": 1340,
    "senderAccountIds": [
      "sa_01HXYZ001",
      "sa_01HXYZ002"
    ]
  }
]
```

## Error Codes

| HTTP Status        | Code                    | Meaning                                                                  |
| ------------------ | ----------------------- | ------------------------------------------------------------------------ |
| `400 Bad Request`  | `invalid_request`       | The request was malformed or contained unexpected parameters.            |
| `401 Unauthorized` | `authentication_failed` | The `Authorization` header is missing, malformed, or the key is invalid. |
| `404 Not Found`    | `workspace_not_found`   | No workspace is associated with the provided API key.                    |