Skip to content
New

Person Report API and New Zealand identity checks are now live.

See what's newarrow_forward
WatchEyeOnboarding & monitoring

Customer onboarding, screening and ongoing monitoring in one system, with real-time KYC and KYB alerts when a customer's risk changes.

Visit WatchEyearrow_forwardcheck_circleIncluded in the Global Data Portal
IDFEX ID CheckIdentity verification

One-to-one identity, document and data checks against the DVS and Australian data sources, run from the Portal or by API.

Visit IDFEX ID Checkarrow_forwardcheck_circleIncluded in the Global Data Portal
ID PassSelf-service verification

Customers verify their own identity and biometrics from a link on their phone. The result comes back to you, and they keep control of their data.

Visit ID Passarrow_forwardcheck_circleIncluded in the Global Data Portal
InsiightData quality

Verifies, corrects and enriches customer records so they stay accurate — one at a time or across your whole database.

Visit Insiightarrow_forwardcheck_circleIncluded in the Global Data Portal
Australian Death CheckDeceased data

The official national death data source. Match your records against it to find and remove deceased individuals.

Visit Australian Death Checkarrow_forwardcheck_circleIncluded in the Global Data Portal
QuesterMarketing lists

Build targeted, privacy-compliant Australian marketing lists with smart filters. Pay only for the records you download.

Visit Questerarrow_forwardcheck_circleIncluded in the Global Data Portal
verified_userVerify Identities7 solutions

Confirm a person or business is who they claim to be: government IDs, biometrics, business registries and employment checks against authoritative Australian sources.

All solutionsarrow_forwardcheck_circleAvailable in the Portal and by API
policy_alertScreen & Monitor7 solutions

Meet AUSTRAC obligations and understand customer risk: screening, risk assessment, fraud controls and investigation tools with evidence recorded for each check.

All solutionsarrow_forwardcheck_circleAvailable in the Portal and by API
databaseImprove your data3 solutions

Keep customer records accurate and put them to work: correct and enrich existing data, unify it into a single view, or build compliant marketing lists from opted-in records.

All solutionsarrow_forwardcheck_circleAvailable in the Portal and by API
monitoringWatchEye API14 categories

The WatchEye API gives programmatic access to everything in WatchEye: PEP and sanctions screening, identity checks, IDPass verifications, monitoring programs, events and reports.

View allarrow_forwardcheck_circleSandbox environment for integration testing
policyAML & screening5 use cases

Obligations under the AML/CTF Act, from screening at onboarding through to ongoing monitoring — with the evidence for each check recorded.

All use casesarrow_forwardcheck_circleMapped to the products and data that cover it
how_to_regOnboarding & identity3 use cases

Verifying who a customer, employee or account holder is — at sign-up and during ongoing checks — against authoritative Australian sources.

All use casesarrow_forwardcheck_circleMapped to the products and data that cover it
databaseData & enrichment4 use cases

Keeping customer records accurate, current and complete: validate contact detail, fill the gaps, locate people and remove deceased records.

All use casesarrow_forwardcheck_circleMapped to the products and data that cover it
Global Data
Portalarrow_forward
Productsexpand_more
Solutionsexpand_more
Use casesexpand_more
Dataexpand_more
APIarrow_forwardIndustriesarrow_forwardResourcesarrow_forwardAboutarrow_forwardContactarrow_forward Request a Demo
Talk to the team

9am–5pm AEST, Monday to Friday.

call03 9948 4089
WatchEye · Events

Update an event

Updating an event moves it through triage or attaches a note, or both in one call. The status can be set to any lifecycle value, and each note supplied creates a new note attributed to the calling API key. At least one of status or note must be sent, and the response returns the event with its notes.

  • Any of the six statuses, so an integration can open, work and close an event
  • A new note of up to 5000 characters on each call, visible in the portal alongside user notes
For developers

After the technical detail?

For the technical detail, go to the API documentation. It holds the request and response schema, the integration guides and the error codes for this endpoint.

  • Request and response schema
  • Statuses, notes and attribution
Go to the API docs

New accounts begin with sandbox access.

ISO 27001 certified Handled under Australian privacy law Every API call written to the audit log
What the check gives you

Writing the triage decision back to the queue

A case system that pulls events should also close them: confirmed, dismissed, duplicate or error, with a note saying why. This call records both, and the audit log records which integration made the change.

Where the event now stands

The status is set to new, investigating, closed confirmed, closed dismissed, closed duplicate or closed error. The response carries the event with its full notes collection.

What was recorded

Each call that supplies a note creates a new note of up to 5000 characters, attributed to the calling API key. Existing notes are not edited by this endpoint; the notes endpoints manage them.

Who made the change

A status change by an API key clears the portal's last actioned by attribution, because a key is not a user. The audit log records the API key and the request's API reference, so the integration is always identifiable.

How a check runs

How an event moves through triage

A match arrives as a new event. Someone picks it up as investigating. It is closed with one of four reasons, of which only closed confirmed means the match was real.

Sending neither a status nor a note returns 400. Notes created here cannot be edited or deleted from the portal, only through the notes endpoints by an API key on the same account.

Reading the result

What each answer means for the record in front of you

The status carries the triage decision. The four closures are not interchangeable: three record why a match was not real, and one records that it was.

New

Raised and not yet looked at

Screening produced a match that someone should review. The check summary says what was searched, the check result identifiers point at the underlying match data, and the notes count is zero until someone writes one.

Investigating

Someone is working it

A person or an integration has picked the event up. Notes attached along the way record what was found, and the event stays here until it is closed with a reason.

Closed confirmed

The match was real and acted on

The only closure that means the screening found something true. The other three, dismissed, duplicate and error, record why the match did not stand, which is the reporting value of the queue.

What it costs

Charged when screening runs, not when records are managed

Charges arise when screening runs against the entities in a program: each check type launched against an entity is charged at launch, and a monitor run is charged for each entity eligible for its operation. Rates are set for your account and communicated by your Global Data account manager, and statements with a per-call breakdown are in the WatchEye portal.

  • Billed per screening operation
  • Refunded if the provider fails
How billing works
Credits drawn down against your account balance
  • A screening check is charged per check type when it is launched, and refunded if the provider fails.
  • A monitor run bills only for the entities eligible for its operation; a UK check skips businesses outside the UK, for example.
  • A run that would exceed the account's credit is refused with 402 and a billing breakdown, before anything is queued.
  • Reads, lists and PDF downloads are not billed.
Talk to us about rates
Related checks

Others in WatchEye Events

Show an event reads the result with its notes. List events finds the events to work. Update a note and Delete a note manage the notes this call creates.

Questions

Questions we get asked about updating an event

Do we need a developer to implement this?
Yes. This is a single REST PATCH by UUID, so a developer wires it to the point where your case system records a decision. A sandbox account is available for development at no charge. It is a separate account with its own API keys, it returns test data in the same response shapes as live, and the same base URL serves both environments.
What does our system need to send?
The event UUID in the path and at least one of a status or a note of up to 5000 characters. Sending neither returns 400.
What are the event statuses?
New, when the event has been raised and not yet triaged. Investigating, when someone or some integration is working it. Then four closures: closed confirmed for a match that was real and acted on, closed dismissed for a false positive, closed duplicate when it duplicates another event, and closed error when it was caused by a data entry error. Only closed confirmed means the match was real.
What comes back?
A 200 with the event as it now stands, including the full notes collection, in the same shape as Show an event.
Can we edit a note we added earlier?
Not with this endpoint; each note supplied creates a new note. Notes created by an API key cannot be edited or deleted from the portal, but any API key on the same account can manage them with Update a note and Delete a note.
How is the change attributed?
The note carries the API key's UUID and label as its author. A status change clears the portal's last actioned by attribution, and the audit log records the API key and the request's API reference.
What if the event has been deleted?
Soft-deleted records return 404 from this endpoint and are no longer returned by the list. They remain in the database for compliance and audit purposes and can be restored in the portal within 30 days by a user with the account manager role.
Getting started

The first step to access is a conversation

Sandbox accounts are provisioned by your Global Data account manager. API keys are created and managed in the WatchEye portal, and the same endpoints serve sandbox and live; the account behind the key decides which environment you are in.

Call 03 9948 4089, 9am–5pm AEST Monday to Friday

ISO 27001 certified
Handled under Australian privacy law
Every API call written to the audit log