Rivier/ Reference/ voice

Check the format of a phone number without a network call

get/lookup/validate

Check the format of a phone number without a network call: valid or not, why, its country, a readable form, and whether its shape says mobile, toll-free or premium-rate.

Before you call

Credential
Authorization: Bearer $KEY
Scope
voice:read
Mcp
rivier_lookup_validate
Graphql
Query.voiceLookupNumberValidate
Sdk
lookup.validate
Cli
lookup validate

Parameters

  • numberstringrequired
    In the query
  • countryCodestring
    In the query

Responses

  • 200application/json
    Success
    • 400application/json
      The request was malformed
      • errorstringrequired
      • messagestring
    • 401application/json
      No valid credential
      • errorstringrequired
      • messagestring
    • 403application/json
      The credential lacks the scope, origin or address
      • errorstringrequired
      • messagestring
    • 429application/json
      Over the key's rate limit; see Retry-After
      • errorstringrequired
      • messagestring

    This page as Markdown