Sourcier Phone Utils icon

Sourcier Phone Utils

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

Actions10

Phone Geo → Get Timezone

AI-generated

Summary

Retrieve the IANA timezone(s) associated with one or multiple phone numbers, resolving them to timezone data using the Sourcier API.

Inputs

  • Authentication (required) — Choose between User Credentials (Email & Password) or Enterprise Credentials (API Key) to authenticate with the Sourcier API.
  • Input Mode (required) — Specify how to provide phone numbers: manually entered, mapped from input fields, or extracted from Bullhorn entity phone fields.
  • Phone Number(s) (required) — Enter one or more phone numbers manually, separated by commas (used only if Input Mode is Manual Input).
  • Source Field (required) — The name of the input data field containing phone numbers (used if Input Mode is Field Mapping).
  • Output Field — The name of the field to store the resulting timezone(s) (used if Input Mode is Field Mapping). If empty, the source field name is used with a suffix.
  • Entity Type (required) — Select the Bullhorn entity type (Candidate, Client Contact, Client Corporation, or Lead) to process (used if Input Mode is Bullhorn Entity).
  • Phone Fields (required) — Choose which Bullhorn phone fields to process (e.g., phone, mobile) when Input Mode is Bullhorn Entity.
  • Batch Mode — When using Field Mapping or Bullhorn Entity input modes, sets whether to process all input items in a single API call for efficiency.
  • Error Handling (required) — Control how the node behaves on errors: fail fast, continue, or collect errors and include them in output.
  • Default Country (required) — Specify the default country to interpret phone numbers missing a country code (e.g., US, GB, CA).
  • Country Code — Provide a custom ISO 3166-1 alpha-2 country code if Default Country is set to Other.
  • Locale (required) — Set the language used for location and carrier names in responses (e.g., English, German, Spanish).

Output shape

A list of items with the timezone information for each input phone number.

Supports multiple input modes (manual, field mapping, Bullhorn entity fields). Batch processing is available for non-manual inputs. The output includes timezone data keyed to the input phone numbers with appropriate field naming conventions. Errors can be handled according to the selected mode, including fail-fast and error collection in outputs.

Examples

Example 1: Manual input of multiple phone numbers

Set Input Mode to 'Manual Input' and enter one or more phone numbers separated by commas in 'Phone Number(s)'. The node returns timezone information for each number.

Example 2: Field mapping mode with batch processing

Set Input Mode to 'Field Mapping', specify the source field with phone numbers, and optionally set the output field. Enable 'Batch Mode' to process all items in one API request for better performance on large datasets.

Example 3: Using Bullhorn entity phone fields

Set Input Mode to 'Bullhorn Entity', select the entity type and phone fields to process. The node fetches timezone info for each specified phone field in the input data.

Links

Discussion