Virtual Operator for Device Status
The Virtual Operator provides predefined and deterministic API responses within the Network Registry Playground when using phone numbers associated with the unassigned country code +990. It can be used as a simulated operator for discovery, development and testing of Network Features in scenarios where access to a live operator is unavailable.
To use the Virtual Operator, simply select 'Playground' in your application configuration. All API calls directed to phone numbers with the +990 prefix will automatically be redirected to the Virtual Operator.
All API calls made using the Virtual Operator require to implement the same authentication flows as those made through a regular mobile operator.
Availability
The Virtual Operator is available by default to any application configured for Network Features in a Playground mode. No further configuration is necessary to use the Virtual Operator.
After setting up the application, go to the Playground configuration page and click on "View Available Operators" to expand the list of available Network Features. The first entry corresponds with the Virtual Operator.
It is not necessary to add +990 numbers to your allowlist. Simply make an API call to any of the supported Network Features.
The responses for both the connectivity and roaming endpoints are determined by the trailing digits of the phone number provided:
/roaming
| Phone Number | Response |
|---|---|
| Last two digits are even, e.g. "+9902345600" | "roaming": true "countryCode": 234 "countryName": ["GB"] |
| Last two digits are odd, e.g. "+9902345601" | "roaming": false |
| Last two digits are "11", e.g. "+9902345611" | No country name: "roaming": true "countryCode": 901 "countryName": [] |
| Last two digits are "22", e.g. "+9902345622" | Single country name (Germany): "roaming": true "countryCode": 262 "countryName": ["DE"] |
| Last two digits are "33", e.g. "+9902345633" | Single country name (USA): "roaming": true "countryCode": 310 "countryName": ["US"] |
| Last two digits are "44", e.g. "+9902345644" | Multiple country names: "roaming": true "countryCode": 340 "countryName": ["BL", "GF", "GP", "MF", "MQ"] |
| Last two digits are "99", e.g. "+9902345699" | Operator Error: "status": 400 "code": "INVALID_INPUT" "message": "Virtual Operator predefined error for numbers ending with 99." |
/connectivity
| Phone Number | Response |
|---|---|
| Last two digits are even, e.g. "+9902345600" | Device is connected to the network via mobile data: "roaming": "CONNECTED_DATA" |
| Last two digits are odd, e.g. "+9902345601" | Device is not connected to the network: "roaming": "NOT_CONNECTED" |
| Last two digits are "11", e.g. "+9902345611" | Device is connected to the network via SMS usage: "roaming": "CONNECTED_SMS" |
| Last two digits are "99", e.g. "+9902345699" | Operator Error: "status": 400 "code": "INVALID_INPUT" "message": "Virtual Operator predefined error for numbers ending with 99." |