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

# Number pool

> List and manage the testing numbers assigned to a Sandbox project.

Each Sandbox project can have project-owned testing numbers. These are
`testMode` sessions and do not connect to real WhatsApp recipients.

## List numbers

An organization key with `sessions:read` can list the project's sessions:

```bash theme={null}
curl "https://api.polymorfa.com/v1/sessions?projectId=$PROJECT_ID" \
  -H "Authorization: Bearer $TITAN_ORG_KEY"
```

Testing-number rows have `testMode: true`. Use the returned session identifier
and phone value instead of assuming a fixed number count or number format.

## Add a testing number

Use the public Platform API with an organization key:

```bash theme={null}
curl -X POST "https://api.polymorfa.com/v1/sessions/testing" \
  -H "Authorization: Bearer $TITAN_ORG_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "<project UUID>",
    "name": "CI sender",
    "country": "US"
  }'
```

`projectId` is required. `country` can be `US`, `GB`, `BR`, or `IN` and
defaults to `US`.

## Stop or remove a testing number

Use an organization key with `sessions:manage`:

```bash theme={null}
curl -X POST \
  "https://api.polymorfa.com/v1/sessions/$SESSION_ID/stop" \
  -H "Authorization: Bearer $TITAN_ORG_KEY"
```

```bash theme={null}
curl -X DELETE \
  "https://api.polymorfa.com/v1/sessions/$SESSION_ID" \
  -H "Authorization: Bearer $TITAN_ORG_KEY"
```

Stopping keeps the testing-number record and settings. Removal is permanent.
The current public API does not expose Sandbox message send, history, label, or
number-regeneration endpoints.

<Columns cols={2}>
  <Card title="Claims and devices" icon="lock" href="/sandbox/claims-and-devices">
    Open a testing session in the desktop app.
  </Card>

  <Card title="Sandbox limits" icon="layer-group" href="/sandbox/tiers">
    Current Free number-tier limits.
  </Card>
</Columns>