Skip to main content

Purchase numbers

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

When to use:

  • Purchasing numbers with document verification
  • Bulk number purchase with identity association

purchase.purchases[].id feeds numbers_purchase_update and numbers_purchase_destroy (id, id_in[]). purchase.purchases[].id feeds purchases_destinations_index and purchases_destinations_create (purchase_id). purchase.purchases[].number feeds numbers_purchase_destroy (did_numbers[]). See also: numbers_index.

Request​

Responses​

purchase DIDs and link documents attached to identity