# Saperly Numbers API

**Canonical:** https://apis.io/apis/saperly/saperly-numbers-api/  
**Provider:** Saperly — https://apis.io/providers/saperly/  
**Base URL:** https://api.saperly.com  
**Documentation:** https://saperly.com/docs/api-reference

Saperly Numbers API is one of 16 APIs that [Saperly](https://apis.io/providers/saperly/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include numbers. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

Phone numbers — provision, list, release, and configure the lines in your workspace. Bind a connection to a number to make it answer calls and messages, set a per-number webhook, and override the SMS sender id or caller ID name. The fleet belongs to the workspace your API key resolves to.

## Operations (8)

| Method | Path | Summary |
|---|---|---|
| GET | `/numbers` | List all phone numbers in the workspace |
| POST | `/numbers` | Provision a phone number |
| GET | `/numbers/{id}` | Get a phone number by id |
| POST | `/numbers/{id}/release` | Release a phone number |
| POST | `/numbers/{id}/connection` | Bind a connection to a number |
| POST | `/numbers/{id}/webhook` | Set a number's manual-mode brain URL |
| POST | `/numbers/{id}/sms-sender` | Set the alphanumeric SMS sender id |
| POST | `/numbers/{id}/caller-id` | Set the outbound caller ID name (CNAM) |

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/saperly/refs/heads/main/openapi/saperly-numbers-api-openapi.yml
- **Documentation** — https://saperly.com/docs/api-reference
- **APIReference** — https://api.saperly.com/reference

## Other Saperly APIs (12)

- [Saperly API Token Registry API](https://apis.io/apis/saperly/saperly-api-token-registry-api/)
- [Saperly Assistant API](https://apis.io/apis/saperly/saperly-assistant-api/)
- [Saperly Connections API](https://apis.io/apis/saperly/saperly-connections-api/)
- [Saperly Consent API](https://apis.io/apis/saperly/saperly-consent-api/)
- [Saperly Custom Voices API](https://apis.io/apis/saperly/saperly-customvoices-api/)
- [Saperly Health API](https://apis.io/apis/saperly/saperly-health-api/)
- [Saperly Keys API](https://apis.io/apis/saperly/saperly-keys-api/)
- [Saperly Languages API](https://apis.io/apis/saperly/saperly-languages-api/)
- [Saperly Messaging API](https://apis.io/apis/saperly/saperly-messaging-api/)
- [Saperly Pricing API](https://apis.io/apis/saperly/saperly-pricing-api/)
- [Saperly Usage API](https://apis.io/apis/saperly/saperly-usage-api/)
- [Saperly Voice API](https://apis.io/apis/saperly/saperly-voice-api/)

## Tags

numbers

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/saperly/saperly-numbers-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/saperly/.