Sourcier Geo Utils icon

Sourcier Geo Utils

Address utilities: validate, normalize, format, convert, compare addresses

Actions10

Address Utils → Normalize

AI-generated

Summary

Normalize address data by standardizing and formatting address fields supplied via manual input, Bullhorn entity presets, or parsing a free-form address string.

Inputs

  • authentication — Select the authentication mode (User Credentials or Enterprise API Key) for accessing the normalization service.
  • inputMode (required) — Choose how to provide address data: manual input of fields, Bullhorn entity presets, or parse a free-form address string.
  • address1 — Street address line 1, used when input mode is manual.
  • address2 — Street address line 2 (suite, apt, etc.), used when input mode is manual.
  • city — City name, used when input mode is manual.
  • state — State, province, or region code, used when input mode is manual.
  • zip — ZIP or postal code, used when input mode is manual.
  • countryCode — ISO 3166-1 alpha-2 country code, used when input mode is manual.
  • parseAddressString (required) — Free-form address string to parse into standardized address fields, used when input mode is parseAddress.
  • bullhornEntityType (required) — Bullhorn entity type (Candidate, Client Contact, or Client Corporation) to normalize address fields for, used when input mode is bullhornEntity.
  • bullhornAddressFields (required) — Specify which Bullhorn entity address fields (Primary, Secondary) to normalize, used when input mode is bullhornEntity.
  • errorMode — Define how to handle errors during processing: fail fast, continue ignoring errors, or collect errors alongside successful outputs.
  • defaultCountry — Default country code used for normalization when no country is specified.
  • customCountry — Custom ISO 3166-1 alpha-2 country code to specify when defaultCountry is set to Other.

Output shape

a normalized address object reflecting standardized address fields corresponding to the input method used (manual fields, Bullhorn entities, or parsed string).

Errors are handled according to the selected error handling mode, potentially causing the operation to stop, skip, or include errors in the output. The output respects the input mode, normalizing only relevant fields provided.

Examples

Example 1: Normalize address provided via manual fields

Provide address1, address2, city, state, zip, and countryCode manually; authentication via Enterprise API Key; error handling fail fast; defaultCountry 'US'. Workflow outputs a standardized address object with normalized fields.

Example 2: Normalize address from a free-form string

Input a free-form address string to parse and normalize; authentication via User Credentials; error handling collect; defaultCountry 'US'. Workflow outputs parsed and normalized address fields or includes errors if parsing fails.

Example 3: Normalize Bullhorn entity addresses

Select Bullhorn entity type Candidate and address fields Primary Address; authentication via Enterprise API Key; error handling continue; defaultCountry 'US'. Normalizes the selected Bullhorn entity address fields accordingly.

Links

Discussion