Request flow

The following steps are needed for making a number request:

1. Verify the requirements for the country of your requested numbers.
2. Make sure you have a valid company profile matching the requirements and number type.
3. Call the Get Request Restrictions endpoint to limitations to how many numbers you can request and which range sizes are supported.
4. If you want to use city instead of area code, or if you are requesting numbers within the NANPA region, call Get Locale Options to get a list of possible cities and regions to select. Note: if one of the requirements is "Company address must be in requested prefix region", the area code is required in the request.
5. Check the number availability for the request via the Get Availability endpoint, so that you know if we have numbers available and if these numbers can be immediately assigned to your account.
6. Request the numbers via the Create Number Request endpoint.

Status updates

You will get status updates when the status of a number request changes. The number request can be accepted or rejected by support. A reason will always be supplied with the status update. You can always cancel a number request yourself if it's not yet finalized.

Receiving status updates:

• You will receive an email on the email addresses in the company profile each time the status is updated.
• If you have supplied a callback URL, you will get a callback each time the status is updated containing the full number request also found in Get Number Request.
• You can always check the request and it's status yourself via the Get Number Request endpoint.
• Find out which possible statuses a number request can via the Get Number Request Statuses endpoint.

Completed requests

When the request is completed, a number will be assigned to you. The number can be configured in the Voice Management App under the Numbers tab in the sidebar.