managing-numberslisted
Install: claude install-skill SendlyHQ/sendly-skills
# Managing Numbers with Sendly
List the numbers your workspace owns, inspect a single number, pick the default sender, and release numbers you no longer need. To *buy* a new number, see the discovery/buy flow at the end.
## Quick start
```typescript
import Sendly from "@sendly/node";
const sendly = new Sendly(process.env.SENDLY_API_KEY!);
const { numbers } = await sendly.numbers.list();
for (const n of numbers) {
console.log(`${n.phoneNumber} — ${n.status}`);
}
```
## Authentication
All requests require a Bearer token (`SENDLY_API_KEY`). Reads need the `numbers:read` scope; mutations (set default, cancel release, release) need `numbers:write`.
## REST API
**Base URL:** `https://sendly.live/api/v1`
### The owned-number shape
```json
{
"id": "num_abc123",
"phoneNumber": "+14155551234",
"status": "active",
"source": "purchased",
"countryCode": "US",
"phoneNumberType": "toll_free",
"monthlyCostCents": 110,
"isDefault": true,
"requirementsSubmittedAt": null,
"pendingCancellation": false,
"scheduledReleaseAt": null
}
```
- `status` — `provisioning`, `requirements_required`, `active`, or `failed`. A number can only send once it is `active`.
- `requirementsSubmittedAt` — for a `requirements_required` number, `null` means "still needs documents", non-null means "documents submitted, under carrier review".
- `isDefault` — only present on the single-number responses (`GET /numbers/:id`, `PATCH /numbers/:id`); the list projection omits it.
- `pendingCa