Phone Numbersv2

Look up a phone number

GET/phone-numbers/lookup

Returns detailed information about a phone number including validation, formatting (E.164, national, international), number type, and NANPA geocoding (city, state/province) for North American numbers. The geocoding data is sourced from different database with 240,000+ NPA-NXX entries.

Requires an Enterprise plan (Dedicated Enterprise). Returns 403 if your organization does not have an active enterprise subscription.

Headers

AuthorizationRequiredstring

Your API key, sent as a bearer token: Authorization: Bearer <api_key>. Editing this stays in sync with the API key box on the right.

Bearer

Query parameters

numberRequiredstring

Phone number to look up. Can be E.164 format (+12125551234), national format (2125551234), or with formatting ((212) 555-1234).

Returns

inputoptionalstring

The original input string

validoptionalboolean

Whether the phone number is valid

possibleoptionalboolean

Whether the phone number is a possible number (less strict than valid)

e164optionalstring

E.164 formatted number

nationaloptionalstring

National formatted number

internationaloptionalstring

International formatted number

country_calling_codeoptionalstring

Country calling code without +

countryoptionalstring | null

ISO 3166-1 alpha-2 country code

national_numberoptionalstring

National number without country code

typeoptionalstring

Number type detected by libphonenumber

"FIXED_LINE""MOBILE""FIXED_LINE_OR_MOBILE""TOLL_FREE""PREMIUM_RATE""SHARED_COST""VOIP""PERSONAL_NUMBER""PAGER""UAN""VOICEMAIL"

locationoptionalobject | null

NANPA geocoding location (only for North American numbers with country code 1)

cityoptionalstring | null

City name

regionoptionalstring | null

State/province abbreviation

region_nameoptionalstring | null

Full state/province name

area_codeoptionalstring

NPA area code (first 3 digits of national number, only for NANP numbers)

exchangeoptionalstring

NXX exchange code (digits 4-6 of national number, only for NANP numbers)

area_code_regionoptionalstring

General region for the area code (most common city, only for NANP numbers)

Response codes

200Phone number information

400Invalid request parameters

401Authentication required or invalid

403Enterprise plan required. Upgrade to Dedicated Enterprise to access this endpoint.

Sends a live request with your values and shows the real response below. Your key is stored only in this browser.

Request

curl -X GET https://api.blooio.com/v2/api/phone-numbers/lookup?number=%2B12125551234 \  -H "Authorization: Bearer bl_live_..."

Response objectexample

{  "input": "+12125551234",  "valid": false,  "possible": false,  "e164": "+12125551234",  "national": "(212) 555-1234",  "international": "+1 212 555 1234",  "country_calling_code": "1",  "country": "US",  "national_number": "2125551234",  "type": "FIXED_LINE_OR_MOBILE",  "location": {    "city": "New York",    "region": "NY",    "region_name": "New York"  },  "area_code": "212",  "exchange": "555",  "area_code_region": "New York, NY"}