Network Registry Playground

The Network Features requires operators' approval. This process could take more or less time, but developers can only use the APIs once the first approvals arrive.

The Playground allows developers to start using the Network Features while waiting for approval of their business profile by the operators.

Enable the Playground in your Application

To start using the Playground, you will need to create an application:

  1. Click the “Create Application" button or navigate to the Applications section of your dashboard and "Create a new application".
  2. Generate a public and private key pair for JWT creation during authentication. You'll need this JWT token to generate access tokens.
  3. Finally, enable the Network Features capability in your application and select the “Playground” access type.
Enable Network Registry Playground within the Application configuration

Once the Playground is configured and the Network Features capability is added to your application, you can begin testing Vonage Network Features. The Playground can either use live data, where developers can configure up to 5 allowlisted phone numbers, or a Virtual Operator, which provides predefined and deterministic API responses using the parameters of the API request. You will find more information on both methods below.

Virtual Operator

The Playground requires at least one working phone number added to the allowlist from a supporting operator and, in some cases, mobile data access to a supported operator. There may be scenarios where allowlisting a valid phone number is not possible, such as when testing the Network Features in a country that is not yet supported.

To solve this situation, the Playground offers a Virtual Operator that provides predefined and deterministic API responses based on the parameters of the API request. See the Virtual Operator guide for your chosen API for more detailed information:

Allowlist Phone Numbers

To use live data with the Playground, open the Vonage Network Registry Playground in your dashboard and select the “Network Registry Playground” tab button. Then, click “View Available Operators” to uncollapse the list of available network partners that can be used in the Playground. You can add up to 5 numbers to be allowlisted from one or more available operators.

Phone numbers added to the allowlist will expire after 30 days or once they reach 200 requests. Expired numbers are automatically removed from the allowlist. Users can always re-validate a phone number to add it back to the allowlist.

The network registry dialog with the Network Registry Playground tab selected

Click on the “Add numbers” button, and for each test phone number, do the following:

  1. Choose the country code from the available countries
  2. Input the phone number you'll use for testing
  3. Check the box to confirm the number will only be used for test purposes
Enter test phone number dialog

Click "Verify" and the phone number will receive an authentication code via SMS. Enter the code provided to complete the number verification.

Once the verification code is added and verification is successful, the test number will be allowlisted successfully and you are ready to start testing the Network Features.