Rivier/ Reference/ voice

Voice phone number search

get/phone/numbers/search

Phone numbers available to buy in a country, with monthly price and what the country requires. Searching costs nothing and buys nothing.

Before you call

Credential
Authorization: Bearer $KEY
Scope
voice:read
Mcp
rivier_phone_number_search
Graphql
Query.voicePhoneNumberSearch
Sdk
voice.phoneNumber.search
Cli
voice phone number search

Parameters

  • countrystringrequired
    In the query
  • typestring
    In the query
  • areaCodestring
    In the query
  • containsstring
    In the query
  • limitinteger
    In the query

Responses

  • 200application/json
    Success
    • numberslist of objectrequired
    • 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