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.
Authorizations
Bearer token via Authorization header
Headers
Optional request idempotency key.
1 - 128Body
Prefer a free package seat ('included', default) or force the paid checkout ('rent')
included, rent Optional ISO 3166-1 alpha-2 country code from GET /numbers/countries. Cannot be combined with purpose.
2^[a-z]{2}$"de"
User-defined display label — NFC-normalized, up to 100 GRAPHEMES (not UTF-16 code units; an emoji/flag may span several). Display-only, never used for routing. Also seeds the billing entity name at purchase.
"Support line"
Optional Mobilerun Phone purpose slug from GET /numbers/purposes.
1 - 96"telegram"
Response
Number purchase accepted — poll GET /numbers/phones/{id}