Sourcier Phone Utils icon

Sourcier Phone Utils

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

Phone Utils → Validate

AI-generated

Summary

Validate one or more phone numbers to check their validity and receive detailed error reasons, using Sourcier's phone utility API.

Inputs

  • Authentication — Choose between User Credentials (Email & Password) or Enterprise Credentials (API Key) for authentication.
  • Input Mode (required) — Select how phone numbers are provided: Manual Input (direct entry), Field Mapping (from input data fields), or Bullhorn Entity (using Bullhorn entity phone field presets).
  • 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 — Optional output field name for the validation results when using Field Mapping; defaults to appending a suffix to the source field name.
  • 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 Bullhorn phone fields to validate.
  • Batch Mode — For Field Mapping or Bullhorn Entity input modes, toggle to process all input items in a single API call for efficiency with large datasets.
  • Error Handling (required) — Select how to handle errors: Fail Fast (stop on first error), Continue (skip errors and continue), or Collect Errors (include errors alongside results).
  • Default Country (required) — Set the default country for parsing phone numbers without country codes, selecting from common countries or Other for custom.
  • Country Code — If Default Country is Other, specify the ISO 3166-1 alpha-2 country code for parsing.

Output shape

a list of items, each containing the validation result for a phone number or input item; errors may be included based on error handling settings

Supports batch processing with up to 100 phone numbers per request; outputs contain detailed validation results or error information appended to original input items, with output field names derived from input mode settings.

Examples

Example 1: Manual Input

Enter one or more phone numbers manually in the Phone Number(s) field; configure authentication; set default country if needed; execute to get validation results per phone number.

Example 2: Field Mapping

Map an input field containing phone numbers via Source Field; optionally set Output Field for results; enable Batch Mode for efficient processing of multiple items; handles validation per mapped input.

Example 3: Bullhorn Entity

Select a Bullhorn entity type and the phone fields to validate; enable Batch Mode to process all items at once; returns validation results for each specified phone field in input data.

Links

Discussion