Phone Numbersv2

Batch look up phone numbers

POST/phone-numbers/batch

Look up multiple phone numbers in a single request. Returns the same detailed information as the single lookup endpoint for each number. Maximum 100 numbers per request.

Requires an Enterprise plan (Dedicated Enterprise).

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

Body parameters

JSON

numbersRequiredstring[]

Array of phone numbers to look up

Returns

resultsoptionalPhoneNumberLookupResult[]

Array of PhoneNumberLookupResult

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

200Batch lookup results

400Invalid request parameters

401Authentication required or invalid

403Enterprise plan required

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

Request

curl -X POST https://api.blooio.com/v2/api/phone-numbers/batch \  -H "Authorization: Bearer bl_live_..." \  -H "Content-Type: application/json" \  -d '{    "numbers": [      "+12125551234",      "+14155551234",      "+18582849901"    ]  }'

Body object

{  "numbers": [    "+12125551234",    "+14155551234",    "+18582849901"  ]}

Response objectexample

{  "results": [    {      "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"    }  ]}