BullhornHub Geo Utils icon

BullhornHub Geo Utils

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

Address Convert → Infer Country

AI-generated

Summary

Infer the ISO 3166-1 alpha-2 country code from an address provided via manual fields, Bullhorn entity address fields, or a free-form address string.

Inputs

  • Authentication (required) — Choose between User Credentials (email and password) or Enterprise Credentials (API key) for BullhornHub authentication.
  • Input Mode (required) — Select how to provide the address to infer the country: Manual Input (enter street-level fields), Bullhorn Entity (use predefined Bullhorn entity address fields), or Parse Address String (supply a free-form address string).
  • City — City name when using Manual Input mode.
  • State — State, province, or region when using Manual Input mode.
  • ZIP / Postal Code — ZIP or postal code when using Manual Input mode.
  • Address String (required) — Free-form address string to parse when using Parse Address String input mode.
  • Entity Type (required) — Bullhorn entity type (Candidate, Client Contact, Client Corporation) when using Bullhorn Entity input mode.
  • Address Fields (required) — Which Bullhorn address fields (Primary or Secondary) to process when using Bullhorn Entity input mode.
  • Error Handling (required) — Determines behavior on error: Fail Fast to stop, Continue to skip errors, or Collect Errors to include errors alongside results.

Output shape

a JSON object containing the inferred country code as ISO 3166-1 alpha-2 format

The inferred country code is based on address data sourced according to the selected input mode. Errors are handled per the selected errorMode option. No pagination applies.

Examples

Example 1: Manual Input

Provide city, state, and postal code fields manually to infer country code.

Example 2: Bullhorn Entity

Select a Bullhorn entity type and address fields to infer country code from associated Bullhorn data.

Example 3: Parse Address String

Input a free-form address string that the node parses and then infers the country code from.

Links

Discussion