Purchase a phone number
Numbers
Purchase a phone number
Starts a Mobilerun Phone purchase for the authenticated owner. Accepted requests always return the same asynchronous envelope; poll GET /numbers/phones/ for its business state. purpose and country are mutually exclusive.
POST
Purchase a phone number
Authorizations
Bearer token via Authorization header
Headers
Optional request idempotency key.
Required string length:
1 - 128Body
application/json
Optional Mobilerun Phone purpose slug from GET /numbers/purposes.
Required string length:
1 - 96Example:
"telegram"
Optional ISO 3166-1 alpha-2 country code from GET /numbers/countries. Cannot be combined with purpose.
Required string length:
2Pattern:
^[a-z]{2}$Example:
"de"
Prefer a free package seat ('included', default) or force the paid checkout ('rent')
Available options:
included, rent Response
Number purchase accepted — poll GET /numbers/phones/{id}