BullhornHub Phone Utils icon

BullhornHub Phone Utils

Phone number utilities: parse, format, validate, geocode, carrier, timezone

Actions10

Phone Geo → Get All Geo Data

AI-generated

Summary

Retrieve comprehensive geographic data including location, carrier, and timezone information for one or multiple phone numbers using BullhornHub Phone Utils.

Inputs

  • Authentication (required) — Select authentication mode: User Credentials (email and password) or Enterprise Credentials (API key).
  • Input Mode (required) — Choose how to provide phone numbers: Manual Input by entering numbers directly, Field Mapping by specifying the source and output fields in the input data, or Bullhorn Entity by selecting Bullhorn entity types and phone fields.
  • Phone Number(s) (required) — If Manual Input mode is selected, enter one or more phone numbers separated by commas.
  • Source Field (required) — When using Field Mapping mode, specify the field name in the input data that contains phone numbers.
  • Output Field — (Field Mapping mode only) Specify the field name to store the resulting geo data; if empty, a suffix will be added to the source field name.
  • Entity Type (required) — When using Bullhorn Entity mode, select the Bullhorn entity type such as Candidate, Client Contact, Client Corporation, or Lead.
  • Phone Fields (required) — Select which phone fields of the Bullhorn entity to process (e.g., phone, mobile).
  • Batch Mode — In Field Mapping or Bullhorn Entity mode, enable to process all input phone numbers in batches for efficiency; disabled is the default.
  • Error Handling (required) — Choose error handling behavior: Fail Fast to stop on first error, Continue to skip errors, or Collect Errors to include errors with results.
  • Default Country (required) — Set the default country code to parse phone numbers lacking country codes, with options including US, GB, CA, AU, DE, FR, or Other.
  • Country Code — If Default Country is set to Other, specify the ISO 3166-1 alpha-2 country code (e.g., JP, BR, IN).
  • Locale (required) — Specify the language for location and carrier names in the output (e.g., English, German, Spanish).

Output shape

a list of items corresponding to input phones, each with JSON containing location, carrier, and timezone data or error info if processing failed.

Supports processing multiple phone numbers per item or across items with optional batching (up to 100 numbers per API call). Outputs structured geo data fields suffixed by operation name or stored in a specified output field. Error handling modes control whether errors stop workflow, are skipped, or collected alongside results.

Examples

Example 1: Manual input of multiple phone numbers to retrieve their comprehensive geographic data in English.

Authentication: Enterprise Credentials; Input Mode: Manual Input; Phone Number(s): '+1 (415) 555-2671, +44 20 7123 4567'; Default Country: US; Locale: English.

Links

Discussion