👍

Required plan

Landline phones are available in all plans. Mobile phones are available in the BUSINESS plan only.

Component

Type

Description

@type

String

One of 'mobile’, 'home_phone’, 'home_fax’, 'work_phone’, 'work_fax’ or 'pager’. No default value.

@do_not_call

Boolean

When the indicator is marked as true, this indicates that the US phone number is listed in the National Do Not Call Registry and should not to be contacted for telemarketing purposes.

This indicator can be used solely for the purpose of complying with the US law for preventing phone calls to numbers listed on the DNC list.

We continuously update the DNC registry to stay current. This indication should only be used the same day the API response was received.

country_code

Integer

International call country code. See ITU-T Recommendation E.164

number

Integer

Phone number

extension

Integer

Extension

raw

String

An unparsed phone. Request only.

display

String

The full national phone for display purposes. Response only.

display_international

String

The full international phone for display purposes. Response only.

Search Requirements

For a phone object to be sufficient for a search, it needs to be a valid number. It should contain either a raw phone string or a number and country code.

Raw Phone Parsing

To search using a raw phone number, fill in the raw member of the phone object and we will do the parsing for you. We are using libphonenumber for phone number parsing.

To see the final result of the parsing, take a look at the query member of the response object. It holds the final person that we have searched for.

Example

{
  "country_code": 1,
  "number": 9785550145,
  "@type": "home_phone",
  "display": "(978) 555-0145",
  "display_international": "+1 978-555-0145",
}