Buy number
POST/api/v2/numbers/purchase
Purchase one or more DID numbers with identity document association.
Important notes:
- Can purchase multiple numbers in a single request
- Identities must contain required documents for the number's country
purchase.purchases[].id feeds update_purchased_number and release_number (id, id_in[]).
purchase.purchases[].id feeds list_number_destinations and add_number_destination
(purchase_id). purchase.purchases[].number feeds release_number (did_numbers[]).
See also: list_my_numbers.
Request
Responses
- 200
- 400
- 401
- 422
purchase DIDs and link documents attached to identity
returns bad request
returns unauthorized
returns errors for unprocessed entities