Use Case Examples
Follow step-by-step examples for common DID number purchase flows. Use these examples when you need to buy numbers based on different selection methods, such as location, prefix, verification requirements, or specific number availability. The examples also include emergency calling registration flows. Each use case shows which API endpoints to call, which values to save, and how to move through the flow.
Note
These examples apply to API version 2026-04-16 (latest). For the previous version, see 2022-05-10.
Learn how to purchase and verify a DID number when regulatory requirements apply.
Learn how to filter DID inventory and order a matching number using API v3.
Learn how to retrieve available DID numbers, reserve a selected number, and complete the purchase using API v3.
Learn how to register existing DIDs for emergency calling by using emergency requirements, validations, and verifications.
Learn how to replace the address of an existing emergency calling service by submitting a new emergency verification.