Sourcier Phone Utils icon

Sourcier Phone Utils

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

Actions10

Phone Geo → Get All Geo Data

AI-generated

Summary

Retrieve combined geographic location, carrier, and timezone information for one or multiple phone numbers.

Inputs

  • Authentication — Choose between User Credentials (email and password) or Enterprise Credentials (API key) for Sourcier API access.
  • Input Mode (required) — Select how phone numbers are provided for processing: Manual Input (direct entry), Field Mapping (map from input data fields), or Bullhorn Entity (process predefined Bullhorn entity phone fields).
  • Phone Number(s) (required) — When using Manual Input mode, enter one or more phone numbers separated by commas.
  • Source Field (required) — When using Field Mapping mode, specify the input field name containing the phone number.
  • Output Field — When using Field Mapping mode, specify the output field name for the result; if left empty, it defaults to source field name with a suffix.
  • Entity Type (required) — When using Bullhorn Entity mode, select the Bullhorn entity type to process phone fields for.
  • Phone Fields (required) — When using Bullhorn Entity mode, select which phone fields to process within the chosen Bullhorn entity.
  • Batch Mode — When using Field Mapping or Bullhorn Entity input modes, choose whether to process all input items in a single API call for efficiency with large datasets.
  • Error Handling (required) — Define how to handle errors during processing: Fail Fast (stop on first error), Continue (skip errors), or Collect Errors (include errors alongside successful results).
  • Default Country (required) — Default country code used when parsing phone numbers missing a country code.
  • Country Code — Provide a custom ISO 3166-1 alpha-2 country code if 'Other' is selected as Default Country.
  • Locale (required) — Language for location and carrier names output (e.g., English, German, Spanish).

Output shape

a list of items, each containing the original input data augmented with a field holding geographic, carrier, and timezone details for the phone number(s) processed

Supports processing multiple phone numbers per item. In Manual Input mode, outputs one item per phone number. In Field Mapping and Bullhorn Entity modes, supports batch processing with up to 100 phone numbers per API call. Error handling behavior depends on the selected mode, with errors optionally included in output.

Examples

Example 1: Manually enter multiple phone numbers and get their combined geographic data.

Set Authentication to enterprise with API key, Input Mode to Manual Input, enter phone numbers separated by commas, select 'Get All Geo Data' operation, specify locale and default country.

Example 2: Map phone numbers from input data fields and add geographic data to each item.

Set Input Mode to Field Mapping, specify source and optional output field names, enable batch mode for large datasets, select appropriate error handling, and set locale and default country.

Links

Discussion