You must have a valid payment method on file before purchasing. The purchase creates a monthly subscription that auto-renews.
Endpoint
POST /user/phone-numbers/purchase
Request
Phone number to purchase in E.164 format (e.g.,
+14155551234). Must be a number returned from the search endpoint.Response
Example
201 Created
402 No payment method
400 Already in use