Verify Command - GBG Loqate

The verify command validates contact data against Loqate APIs and returns a confidence score, match-level data, and a policy-aware recommendation.

Usage

lqt verify [flags]

Flag	Description
`-a, --address`	Full address string
`-e, --email`	Email address
`-p, --phone`	Phone number (E.164 format recommended)
`-c, --country`	ISO 2-letter country code
`--policy`	Policy to apply: `strict`, `shipping`, `standard`, `permissive`
`--policy-file`	Path to a custom policy JSON file
`-b, --batch`	Path to a CSV/TSV file for batch processing
`-o, --output`	Output format: `json`, `jsonl`, or `table`
`-k, --key`	Override the Loqate API key
`--field`	Pass extended Loqate input fields
`--option`	Pass additional API options
`--summary`	Display summary statistics (batch mode)

lqt verify -a "10 Downing Street, London, SW1A 2AA, GB" -o json

lqt verify -a "10 Downing St, London, GB" --policy shipping -o json

lqt verify \
  -a "221B Baker St, London, GB" \
  -e "sherlock@example.com" \
  -p "+442071234567" \
  --policy strict \
  -o json

lqt verify -a "125 Summer St, Boston, MA 02110, US" -o table

Field	Description
`confidence`	Score between 0 and 1
`recommendation`	`accept`, `review`, or `reject` based on the active policy
`avc`	Address Verification Code (e.g., `V44-I44-P7-100`)
`verification_status`	`V` (verified), `P` (partially verified), `U` (unverified), `R` (reverified)
`match_level`	`premise`, `street`, `locality`, `administrative_area`, or `country`

Field	Description
`confidence`	Score between 0 and 1
`recommendation`	`accept`, `review`, or `reject`
`response_code`	Loqate email validation response
`risk`	`low`, `medium`, or `high`
`flags`	Array of risk indicators (e.g., `disposable_domain`)

Field	Description
`confidence`	Score between 0 and 1
`recommendation`	`accept`, `review`, or `reject`
`verified`	Whether the phone number is valid
`number_type`	`mobile`, `landline`, `voip`, etc.

Field	Description
`recommendation`	Lowest-confidence field’s recommendation
`confidence`	Lowest confidence score across all verified fields
`policy`	Name of the policy that was applied

The CLI returns exit codes that agents and scripts can use for control flow:

Code	Meaning
`0`	`ACCEPT` — all fields passed the policy threshold
`1`	`REVIEW` — one or more fields need human review
`2`	`REJECT` — one or more fields failed the policy threshold
`3`	`ERROR` — a request or configuration error occurred