# 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](../2022-05-10/examples/index.html#user-panel-api-examples-v33).

**Buy DID Number(s) that Requires Verification**

Learn how to purchase and verify a DID number when regulatory requirements apply.

[Buy a DID Number That Requires Verification](buy-dids-with-verification.html#api-examples-buy-a-did-that-requires-verification)

**Buy Available DID Number(s)**

Learn how to filter DID inventory and order a matching number using API v3.

[Buy Available DID Number(s)](buy-dids.html#api-examples-buy-available-dids)

**Select, Reserve & Buy Available DID Number(s)**

Learn how to retrieve available DID numbers, reserve a selected number, and complete the purchase using API v3.

[Select, Reserve & Buy Available DID Number(s)](buy-reserved-dids.html#api-examples-select-reserve-and-buy-available-dids)

**Register Emergency Calling Service**

Learn how to register existing DIDs for emergency calling by using emergency requirements, validations, and
verifications.

[Register Emergency Calling Service](register-emergency-calling-service.html#api-examples-register-emergency-calling-service)

**Update Emergency Calling Service**

Learn how to replace the address of an existing emergency calling service by submitting a new emergency verification.

[Update Emergency Calling Service](update-emergency-calling-service.html#api-examples-update-emergency-calling-service)