Skip to content
Lira APILira API

Address Verification

Get a verification job

get/address-verification/jobs/{jobId}

Authorization

API key in the X-API-Key header.

Path parameters

jobIdstringrequired

Response

job_idstringrequired
statusstringrequired

pending | tracking | complete | inconclusive | cancelled

confidence_scorenumber | nullrequired
verdictstring | nullrequired

high | moderate | low | inconclusive | null

summaryobject | nullrequired
Show child attributes
observation_daysnumberrequired
nights_observednumberrequired
nights_unobserved_powernumberrequired
nights_unobserved_app_closednumberrequired
nights_at_homenumberrequired
avg_hours_at_homenumber | nullrequired
tracking_windowstringrequired
radius_meters_usednumberrequired
claimed_locationobjectrequired
Show child attributes
latnumberrequired
lngnumberrequired
labelstring | nullrequired
country_codestringrequired
created_atstringrequired
completed_atstring | nullrequired
last_event_atstring | nullrequired

ISO timestamp of the most recent location event we received for this job, or null if none yet.

hours_since_last_eventnumber | nullrequired

Hours elapsed since the most recent event (or job creation if no events). Null for terminal jobs.

window_deadline_atstringrequired

When the observation window ends. The job is closed as inconclusive on or after this instant.

silence_deadline_atstring | nullrequired

When the silence-timeout closure will fire if no further events arrive. Null for terminal jobs.

preliminary_scorenumber | null

Present when status is tracking

confidence_bandstring

low | medium | high — present when status is tracking

nights_remainingnumber

Present when status is tracking