# messagebird Purchased Numbers API

**Canonical:** https://apis.io/apis/bird/messagebird-purchased-numbers-api/  
**Provider:** Bird — https://apis.io/providers/bird/  
**Base URL:** https://numbers.messagebird.com/v1  
**Documentation:** https://developers.messagebird.com/api/sms-messaging/

messagebird Purchased Numbers API is one of 33 APIs that [Bird](https://apis.io/providers/bird/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification. Tagged areas include Purchased Numbers. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an AsyncAPI specification.

Operations for managing purchased phone numbers.

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| GET | `/phone-numbers` | List purchased phone numbers |
| POST | `/phone-numbers` | Purchase a phone number |
| GET | `/phone-numbers/{number}` | View a purchased phone number |
| PATCH | `/phone-numbers/{number}` | Update a purchased phone number |
| DELETE | `/phone-numbers/{number}` | Cancel a purchased phone number |

## Machine-readable artifacts (14)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/bird/refs/heads/main/openapi/messagebird-purchased-numbers-api-openapi.yml
- **Documentation** — https://developers.messagebird.com/api/sms-messaging/
- **Documentation** — https://developers.messagebird.com/api/voice-calling/
- **Documentation** — https://developers.messagebird.com/api/voice-messaging/
- **Documentation** — https://developers.messagebird.com/api/conversations/
- **AsyncAPI** — https://raw.githubusercontent.com/api-evangelist/bird/refs/heads/main/asyncapi/messagebird-conversations-asyncapi.yml
- **Documentation** — https://developers.messagebird.com/api/whatsapp
- **Documentation** — https://developers.messagebird.com/api/verify/
- **Documentation** — https://developers.messagebird.com/api/lookup/
- **Documentation** — https://developers.messagebird.com/api/hlr/
- **Documentation** — https://developers.messagebird.com/api/contacts/
- **Documentation** — https://developers.messagebird.com/api/numbers/
- **Documentation** — https://developers.messagebird.com/api/balance/
- **Documentation** — https://developers.messagebird.com/api/integrations/

## Other Bird APIs (12)

- [Bird Customer Data API](https://apis.io/apis/bird/bird-customer-data-api/)
- [Bird Phone Numbers API](https://apis.io/apis/bird/bird-phone-numbers-api/)
- [Bird Identity Verification API](https://apis.io/apis/bird/bird-identity-verification-api/)
- [Bird Touchpoints API](https://apis.io/apis/bird/bird-touchpoints-api/)
- [Bird Accounts API](https://apis.io/apis/bird/bird-accounts-api/)
- [Bird FAQ API](https://apis.io/apis/bird/bird-faq-api/)
- [Bird Intent API](https://apis.io/apis/bird/bird-intent-api/)
- [Bird SMS Messaging API](https://apis.io/apis/bird/bird-sms-messaging-api/)
- [Bird Channels API](https://apis.io/apis/bird/bird-channels-api/)
- [Bird Contacts API](https://apis.io/apis/bird/bird-contacts-api/)
- [Bird Conversations API](https://apis.io/apis/bird/bird-conversations-api/)
- [Bird Legacy MessageBird API](https://apis.io/apis/bird/bird-legacy-messagebird-api/)

## Tags

Purchased Numbers

---

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