v52

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-311,1941,9384.1 MB

Inventory Level

Create an inventory coverage request

Creates an inventory coverage request. If locality, npa or national_destination_code is used in groupBy, and no region or locality filters are used, the whole paginated set is returned.

get/inventory_coverage

Query parameters

administrative_areastring

Filter by administrative area

countboolean

Include count in the result

country_code'AT' | 'AU' | 'BE' | 'BG' | 'CA' | 'CH' | 'CN' | 'CY' | 'CZ' | 'DE' | 'DK' | 'EE' | 'ES' | 'FI' | 'FR' | 'GB' | 'GR' | 'HU' | 'HR' | 'IE' | 'IT' | 'LT' | 'LU' | 'LV' | 'NL' | 'NZ' | 'MX' | 'NO' | 'PL' | 'PT' | 'RO' | 'SE' | 'SG' | 'SI' | 'SK' | 'US'

Filter by country. Defaults to US

featuresstring[]

Filter if the phone number should be used for voice, fax, mms, sms, emergency. Returns features in the response when used.

groupBy'locality' | 'npa' | 'national_destination_code'

Filter to group results

npainteger

Filter by npa

nxxinteger

Filter by nxx

Filter by phone number type

Consolidated filter parameter (deepObject style). Originally: filter[npa], filter[nxx], filter[administrative_area], filter[phone_number_type], filter[country_code], filter[count], filter[features], filter[groupBy]

{
  "features": [
    "voice",
    "sms"
  ]
}

Response

Successful response with a list of inventory coverage levels

Example response

{
  "data": [
    {
      "administrative_area": "NJ",
      "advance_requirements": true,
      "count": 3,
      "coverage_type": "number",
      "group": "318",
      "group_type": "npa",
      "number_range": 1,
      "number_type": "did",
      "phone_number_type": "local",
      "record_type": "inventory_coverage_group"
    }
  ],
  "meta": {
    "total_results": 25
  }
}