Sourcier Phone Utils icon

Sourcier Phone Utils

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

Actions10

Phone Geo → Geocode

AI-generated

Summary

Geocode phone number(s) to retrieve their geographic location as a readable string (e.g., "San Francisco, CA").

Inputs

  • Authentication (required) — Choose between User Credentials (email & password) and Enterprise Credentials (API key) for Sourcier API authentication.
  • Input Mode (required) — Select how phone numbers are provided: Manual Input (enter numbers directly), Field Mapping (map phone number fields from input data), or Bullhorn Entity (process phone fields from Bullhorn entity presets).
  • Phone Number(s) (required) — Provide one or multiple phone numbers separated by commas when using Manual Input mode.
  • Source Field (required) — Specify the field name containing the phone number in input data when using Field Mapping mode.
  • Output Field — Define the field name for the result in output when using Field Mapping mode; if empty, the source field name with a suffix is used.
  • Entity Type (required) — Select the Bullhorn entity type to process phone fields for when using Bullhorn Entity input mode.
  • Phone Fields (required) — Choose which phone fields to process from the selected Bullhorn entity when using Bullhorn Entity input mode.
  • Batch Mode — Enable this option to process all input items in a single API call for improved efficiency when not using Manual Input mode.
  • Error Handling (required) — Define how errors are handled: Fail Fast (stop on first error), Continue (skip errors), or Collect Errors (include errors alongside successful results).
  • Default Country (required) — Set the default country for parsing phone numbers without an explicit country code.
  • Country Code — Specify a custom ISO 3166-1 alpha-2 country code when Default Country is set to 'Other'.
  • Locale (required) — Select the language for location and carrier names in the output.

Output shape

a list of items where each item's JSON contains the geographic location information for the processed phone number(s).

When using Manual Input mode, the operation processes phone numbers provided as a comma-separated string, returning one location result per phone number. For Field Mapping and Bullhorn Entity modes, it processes phone numbers from each input item and adds the geocode results to specified or generated output fields. Batch Mode optionally processes multiple items' phone numbers in bulk. Errors are handled according to the selected error handling mode, potentially including error details in output.

Examples

Example 1: Manual input of multiple phone numbers

Set Input Mode to Manual, enter multiple phone numbers separated by commas, configure authentication, and run the node to get location names for each phone number.

Example 2: Field Mapping input mode

Map phone number fields from incoming items by specifying Source Field and optionally Output Field, and get location info appended to each item in the output.

Links

Discussion