WatchEye
Browse endpoints
View as Markdown OpenAPI spec

Delete an entity

DELETE /api/v1/entities/{entity_uuid} operationId: entity.delete

Base: https://portal.watcheye.com.au/api/v1/entities/{entity_uuid}

Soft-deletes the entity and its dependent records (checks, ID checks, reports, events, notes and crossmatches). See the Soft Deletion section of the API guide for the full policy (30-day recovery window, portal-only restore, what gets cascaded).

If you need to keep the entity accessible for compliance / audit purposes but no longer want it surfaced in day-to-day workflows, prefer archiving instead of deleting. Archive the entity with POST /v1/entities/{entity_uuid}/archive; archived entities remain visible via list and show endpoints and can be filtered by the archived query parameter.

The records are no longer returned by list/show endpoints but are retained for compliance and audit purposes. The deleted entity record is returned in the response with deleted_at populated.

Path parameters

FieldDescription
entity_uuidrequired string (uuid)

The entity UUID

Responses

200

Entity deleted

application/json
FieldDescription
data object
data.uuid string (uuid)

The entity's UUID

Example: 123e4567-e89b-12d3-a456-426614174000
data.entity_number string

A short obfuscated public identifier for the entity (e.g. "E-A1-B2C-3D4")

Example: E-A1-B2C-3D4
data.reference_number string or null

An optional customer-supplied reference number, unique within the program

Example: CUST-12345
data.entity_type string

The type of entity:

  • individual - A natural person
  • business - A registered business
  • vessel - A vessel
  • property - A real estate property

Enum: individual, business, vessel, property

Example: individual
data.entity_name string or null

The display name of the entity, computed from the relevant type-specific fields

Example: Jane A Doe
data.first_name string or null

First name (individuals only)

Example: Jane
data.middle_name string or null

Middle name (individuals only)

Example: A
data.last_name string or null

Last name (individuals only)

Example: Doe
data.birth_date string (date) or null

Date of birth in YYYY-MM-DD format (individuals only)

Example: 1980-05-15
data.business_name string or null

Business name (businesses only)

Example: Acme Pty Ltd
data.business_number string or null

Business identifier (businesses only); format depends on business_number_type

Example: 12345678901
data.business_number_type string or null

The type of business_number:

  • au_abn - Australian Business Number (11 digits)
  • au_acn - Australian Company Number (9 digits)
  • uk_crn - UK Company Registration Number (8 alphanumeric)
  • other - Other identifier (alphanumeric, max 32 chars)

Enum: au_abn, au_acn, uk_crn, other

Example: au_abn
data.vessel_name string or null

Vessel name (vessels only)

Example: HMAS Sydney
data.property_name string or null

Property name (properties only)

Example: 1 Example Street, Sydney
data.address_line1 string or null

First line of address

Example: 1 Example Street
data.address_line2 string or null

Second line of address

Example: Unit 4
data.address_suburb string or null

Suburb / locality

Example: Sydney
data.address_state string or null

State / region (Australian state code if address_country is AU)

Example: NSW
data.address_postcode string or null

Postal / zip code

Example: 2000
data.address_country string or null

Two-letter ISO 3166-1 alpha-2 country code (e.g. AU). Either case is accepted; responses use uppercase.

Example: AU
data.phone1 string or null

Primary phone number

Example: +61412345678
data.phone2 string or null

Secondary phone number
data.phone3 string or null

Additional phone number
data.phone4 string or null

Additional phone number
data.email1 string (email) or null

Primary email address

Example: jane.doe@example.com
data.email2 string (email) or null

Secondary email address
data.email3 string (email) or null

Additional email address
data.email4 string (email) or null

Additional email address
data.flags array of strings

Manual flags applied to the entity. Permitted values:

  • sanction - Sanctions
  • pep - Politically Exposed
  • adverse_media - Adverse Media
  • fraud - Fraud
  • hardship - Hardship
  • bankruptcy - Bankruptcy
  • deceased - Deceased
  • court_actions - Court Actions
  • deregistered - De-Registered
  • external_administration - External Administration
data.risk_level string or null

Risk level assigned to the entity:

  • low - Low
  • medium - Medium
  • high - High
  • null - no risk assigned (the risk has not yet been established)

Enum: low, medium, high

Example: low
data.archived_at string (date-time) or null

ISO 8601 timestamp at which the entity was archived (null if not archived)

Example: 2025-04-01T10:00:00Z
data.deleted_at string (date-time) or null

ISO 8601 timestamp at which the entity was soft-deleted (null if not deleted). Only populated on the response from a DELETE call.

Example: 2025-04-01T10:00:00Z
data.program_uuid string (uuid)

UUID of the program this entity belongs to

Example: 9c3e0a8e-2b9f-4f0e-8d1a-1e2b3c4d5e6f
data.created_at string (date-time)

ISO 8601 timestamp at which the entity was created

Example: 2025-01-01T00:00:00Z
data.updated_at string (date-time)

ISO 8601 timestamp at which the entity was last updated

Example: 2025-01-01T00:00:00Z
api_reference string (uuid)
Standard error responses: 400 401 402 403 404 429 5XX See common error responses
Previous Update an entity Next Archive an entity