Number Verification API HTTP responses

This section provides example responses returned when using the Number Verification API.

200header link

When you get a successful response with the verified number data.

• Verify (POST .../v0/verify or POST .../v2/verify): returns devicePhoneNumberVerified.
• Phone number share (GET .../v1/device-phone-number or GET .../v2/device-phone-number): returns devicePhoneNumber.

{
    "devicePhoneNumberVerified": true
}

400header link

When there are issues, such as invalid arguments in the client request:

{
    "status": 400,
    "code": "INVALID_ARGUMENT",
    "message": "Client specified an invalid argument, request body or query param"
}

401header link

When there is an authentication issue with the client request:

{
    "status": 401,
    "code": "UNAUTHENTICATED",
    "message": "Request not authenticated due to missing, invalid, or expired credentials"
}

403header link

When a client does not have the right or enough permissions to access device data. Other scenarios may exist within the Number Verification API, such as:

{
    "status": 403,
    "code": "PERMISSION_DENIED",
    "message": "Client does not have sufficient permissions to perform this action"
}

{
    "status": 403,
    "code": "NUMBER_VERIFICATION.USER_NOT_AUTHENTICATED_BY_MOBILE_NETWORK",
    "message": "Client must authenticate via the mobile network to use this service"
}

{
    "status": 403,
    "code": "INVALID_TOKEN_CONTEXT",
    "message": "Phone number cannot be deducted from access token context"
}

500header link

For internal server errors, you can contact Network as Code support team.

{
    "status": 500,
    "code": "INTERNAL",
    "message": "Server error"
}

503header link

Service is unavailable. Typically, the server is down. Contact Network as Code support team and check when the service will return.

{
    "status": 503,
    "code": "UNAVAILABLE",
    "message": "Service unavailable"
}

504header link

The request time has been exceeded. If it happens repeatedly, consider reducing the request complexity. You can also contact Network as Code support team for possible solutions.

{
    "status": 504,
    "code": "TIMEOUT",
    "message": "Request timeout exceeded. Try later."
}

Last updated September 18, 2026