Person Report Result

The request_uuid returned by POST /person_report.

When true, return the completed report as a PDF document instead of JSON.

Default: false

Example: Ok

Reference for this poll call.

The api_reference of the originating request (billing correlation id).

Enum: pending, processing, complete, error

Present when status is complete. Echo of the supplied identifiers, normalised as searched. Fields not supplied are omitted.

Present on a resolved report. A front-page summary in five fixed parts: who was resolved and on what evidence, what was found, which findings are name-only leads, and what to verify next. On live reports it is written by an AI language model from a redacted digest of the finished report - no phone, email, street address, full date of birth or relative's name leaves the report - and is marked ai_assisted. When the model is unavailable, and always in the sandbox, a templated summary with the same parts is produced instead (generated_by: template). The summary adds nothing to the report; where they differ, the report is correct.

Enum: ok

Enum: ai, template

Why a templated summary was produced on a live report, when it was.

Example: John Andrew Smith resolved at high confidence; findings in court and adverse media.

Who was resolved, from how many records and candidates, what matched and corroborated, and the deceased check outcome.

What is attributed to the subject - addresses, contacts, business and registers, household, watchlists, social profile.

Every name-only lead with its count, each marked as not verified as the subject.

Conditions of use for an AI-written summary. Present when ai_assisted is true.

Present when status is complete.

Enum: resolved, low_confidence, ambiguous, too_many, not_found

Enum: high, medium, low

Per-field comparison of the supplied details with the resolved subject.

Redacted candidates (ambiguous / low_confidence only).

Re-submit this to POST /person_report to select the candidate. Valid for one hour, same environment only.

First and last year the candidate is seen.

Enum: high, medium, low

On a resolved outcome with more than one surviving candidate - the same-name records that were examined and set aside, with the reason. No selection tokens; re-submit with narrower details (a date of birth, a state, a phone) to reach one of these instead.

Example: scored 30 against the resolved subject's 45, and nothing corroborated it

Narrowing hints (too_many / ambiguous / not_found).

Present when status is complete and resolution.outcome is resolved.

Example: asic+global_data

Every date of birth seen, with its supporting votes.

Enum: match, near_miss, same_year, no_match, no_data, not_provided

True when the death register confirmed a record, false when the check found no match, null when no check could be performed.

Custodian deceased check against the Australian Death Check registry, on name and date of birth.

Enum: confirmed, no_match, not_performed, error

Example: No, ADC check found no match

Whether the subject's own Global Data record carries a deceased flag, independent of the registry check.

Date of death from the Global Data record, when flagged.

Address timeline, most recent first.

Example: residential

True for postal or high-occupancy addresses, which are excluded from household inference.

Example: same_surname

Date the co-resident was first and last seen at the address.

The window both were at the address, when the tenures overlap.

Example: sold

E.164 format.

Example: mobile

True when this contact was one of the supplied identifiers.

Live presence check at report time. The most recent contacts are checked, up to a per-request cap; the rest are not_checked. A contact that did not answer in time is undetermined.

Enum: connected, disconnected, undetermined, invalid, not_checked

Example: Network confirmed connection

Approximate location for the number, when the check reports one.

Live deliverability check at report time; see the phone connectivity for the cap and timing rules.

Enum: deliverable, undeliverable, undetermined, invalid, not_checked

False when the mailbox accepts mail but should not be sent to (for example a spam trap or role account).

Example: Mailbox not found

Why this person is suggested - co-resident with the same surname, or a rare-surname match graded by proximity.

ABN registrations linked to the subject by locality.

Example: name_and_postcode

Businesses associated through the subject's identifiers (e.g. an email domain) - unverified.

Example: email_domain

Count of same-name ABN holders elsewhere that were not linked.

Enum: found, not_found, indeterminate

Dates of birth on ASIC records that differ from the confirmed date (data-entry variants).

UK Companies House officer search for the subject: current and resigned officers of UK companies plus disqualified directors. One search on the subject's name, filtered to the subject's birth month when a date of birth is known (the register publishes year and month of birth only, never the day). found means name and birth month agree; name_only means no date of birth was available to check and the records are leads. Appointments are listed for up to three matching officers, birth-month agreement first.

Enum: found, name_only, not_found, indeterminate

Example: John Andrew Smith

Whether the subject's birth month was applied to the search.

How many matching officers are disqualified directors.

How many matching officers have a service address in the subject's address history.

The register held more same-name officers than were retrieved.

The register's officer id, usable with company_house_officer_report.

The name as the register writes it (given names then SURNAME).

Example: John Andrew SMITH

Year and month of birth as published, YYYY-MM.

Example: 1998-03

Enum: agrees, not_on_record, not_checked

The officer's service address as a single line.

Whether the service address is one of the subject's own addresses.

Enum: address_history, no_match, not_checked

The subject's address the service address agrees with.

Current appointments first, then by appointment date, newest first. Empty when the officer report was not retrieved.

Example: active

Example: director

The service address recorded on this appointment.

Disqualification orders, for a disqualified director.

Example: court-order

PEP, sanctions and debarment matches for the subject's name (and date of birth where the record holds one), most credible first: matches whose date of birth agrees with the subject, then those with no date of birth on record, then by name similarity. Never verified as the subject.

Enum: clear, matches, error

The record's display name.

Example: Penny Wong

The name form that matched the search.

Name similarity, 0-100.

How the subject's date of birth compares with the record's.

Enum: agrees, year_agrees, not_on_record, differs, not_checked

Every list the record appears on.

Example: au_parliament

Example: Australian Parliament Members

Enum: pep, sanction, debarment

Example: Person

Positions held, current first then most recent. Keys present only when known.

Example: Minister for Foreign Affairs

ISO 3166-1 alpha-2, lower case.

Example: au

The record's properties by name, each a list of strings; only non-empty ones are present. Keys: names, aliases, weak_aliases, title, gender, birth_dates, death_dates, birth_place, birth_country, nationality, citizenship, country, political_party, education, religion, professions, classification, keywords, notes, addresses, phones, emails, websites, source_urls, wikipedia_url. Names include every script the record holds.

Enum: clear, matches, error

Example: ato_disqualified_trustee

Enum: clear, matches, error, skipped

Enum: criminal, civil

Example: false

The most recent individual court records held under the names in summaries, newest first, capped at records_limit. Matched on name (and state) only - never verified as the subject.

Example: SMITH, John Andrew

Enum: criminal, civil

Example: 2023-02-21

Example: Melbourne Magistrates' Court

Example: VIC

Example: Mention

Any further descriptive lines the court record carries (charge, matter type, informant).

Example: false

Maximum number of records returned in records.

Example: 10

Conditions of use for court records. Present whenever the section ran.

Example: Court records must only be used in accordance with the Global Data Terms of Use. Records are provided based on the searched name and state only. Organisations must make further enquiries to ascertain that the subject being searched is associated with the displayed records.

Adverse media on the subject's name, via the same research as adverse_media_check: a news and regulator search, then an AI-assisted web research pass that writes a summary, cites the articles it drew on and classifies what it found. This is the one AI-assisted section of the report and is marked as such (ai_assisted). The research is keyed on name and country only, so matches means adverse media exists for someone carrying the subject's name - it is a lead, not a verified finding. The only corroboration available is the age the media reports, compared with the subject's date of birth (age_match). Results are cached for 14 days.

Enum: clear, matches, error, skipped

Example: John Andrew Smith

Country the research was scoped to (ISO 3166-1 alpha-2).

Example: AU

Always true. The summary is machine written from the linked sources.

Example: true

The subject's name as the media writes it.

The age the media reports, where an article states one.

agrees when the reported age is within a year of the subject's current age, differs when it is not, not_reported when no article states an age, not_checked when the subject has no date of birth.

Enum: agrees, differs, not_reported, not_checked

The subject's location as the media reports it.

AI-written summary of the adverse media found, highlighting the nature of the issues and when they occurred.

Categories of misconduct the media describes.

Enum: financial_crime, violent_crime, organised_crime, drug_offences, sexual_offences, regulatory_action, terrorism, scams_and_fraud, environmental_violations, employment_violations, corruption_and_abuse_of_office

The articles and pages the summary was written from.

Conditions of use for adverse media findings. Present whenever the section ran.

Why the section is error or skipped.

The inference id (adverse_media.name_match_unverified) the finding rests on. Present when status is matches.

Example: I4

Professional profile matched on one of the subject's phones or emails. When the profile's name agrees with the subject the status is ok and the profile is attributed to them. When it does not (a different name, a different first name, or no name at all) the profile is still returned with status unverified, a name_match value and a warning: it may be the subject under another name, or whoever shares or previously held the contact, and must not be relied on without further enquiry.

Enum: ok, unverified, empty, skipped

How the profile's name compares with the subject's.

Enum: match, partial, mismatch, unknown

Present when status is unverified.

Enum: phone, email

Provider match likelihood, 1-10.

Full date of birth when the profile holds one.

The profile's current location; keys present only when known.

Other locations the profile has been seen at, most recent first.

Street addresses held on the profile. Leads only - not verified against the subject's address history.

Job function, e.g. finance.

Employment history, most recent first. Keys present only when known.

Most recent first. Keys present only when known.

Majors, minors and degrees combined.

work, personal, current professional, etc. when the provider says.

The provider's recommended personal email.

global_data when the same email is on the subject's Global Data record.

Enum: mobile, null

The provider's own quality signals for the record.

Per-section outcome, e.g. {"identity":"ok","watchlists":"clear","business":"empty","court":"error"}.

Present when status is complete.

Every lookup performed, with the exact query, dataset or provider, round and result count.

Every conclusion drawn, with the rule applied and the evidence it rests on.

Chronological research log.

Enum: input, lookup, finding, decision, rejected, not_attempted, outcome