Global Data
Browse endpoints
View as Markdown OpenAPI spec

ADC Check

POST /api/v2/adc_check operationId: adc_check

Live: https://gdapi.globaldata.net.au/api/v2/adc_check · Sandbox: https://sandbox-gdapi.globaldata.net.au/api/v2/adc_check

The ADC Check API allows you to check if an individual is recorded as deceased against the ADC (Australian Death Check) service.

Note: If you are looking for ADC Check (Custodial), please refer to the Deceased Check endpoint.

ADC Check

The returned records are checked against the ADC (Australian Death Check) service and any matching records are returned in the 'matches' field of the response. Note that the ADC check is performed based on the name and date of birth of the individual. The results will also include the state of the individual, and this should be taken into account when determining if the result is a match.

When searching a name, the first and last names must match exactly. The optional middle name(s) can be partial matches. It is recommended that the full name (including middle names) are used when searching for a name.

Examples:

Assuming the ADC has the following record: Name: John Henry Smith

Different search names and the expected matched name result:

Searched First Name Searched Middle Name Searched Last Name Matched First Name Matched Last Name name_match
John Henry Smith John Henry Smith exact
John Henry Peter Smith John Henry Smith partial
John Peter Henry Smith John Henry Smith partial
John Peter Smith John Henry Smith partial
John Smith John Henry Smith partial

Sandbox environment data

When simulating queries in the sandbox environment, the following records will return a match:

Reference First Name Last Name State Date of Birth Date of Death Date of Death Range
123400001 John Smith VIC 1998-03-21 2023-07-24
123400002 John Doe NSW 1971-01-23 2003-08-22
123400003 John Andrew Doe WA 1971-01-23 2011-11-03
123400004 Mary Smith NSW 1965-02-17 Between 31/12/2018 and 2/2/2019

Request body

Content type application/json. The details of the record to search

FieldDescription
first_name string

The first name of the individual

Example: John
middle_name string or null

The optional middle name of the individual

Example: Andrew
last_name string

The last name of the individual

Example: Smith
birth_date string (date)

The date of birth of the individual

Example: 1998-03-21

Responses

200

Successful response

application/json
FieldDescription
message string

A message indicating the result of the request. This will be Ok if the request was successful.

Example: Ok
api_reference string (uuid)

A unique identifier for this request. This can be used to track the request in the logs.

Example: fe4291ca-d831-4760-96df-c9cb03b3cd95
matches array of objects

Array of matched records.
matches[].first_name string

The first name (and middle name if applicable) of the matched individual.

Example: John Andrew
matches[].last_name string

The last name of the matched individual.

Example: Smith
matches[].date_of_birth string or null

The dob of the matched individual.

Example: 1998-03-21
matches[].date_of_death string or null

The date of death of the matched individual.

Example: 2023-07-24
matches[].date_of_death_range string or null

The date range of death of the matched individual.

Example: Between 31/12/2018 and 2/2/2019
matches[].state string

The state of the matched individual.

Enum: ACT, NSW, NT, QLD, SA, TAS, VIC, WA

Example: VIC
matches[].reference string

The ADC reference number of the matched record.

Example: 123400001
matches[].name_match string

The type of match for the name.

  • exact: The name is an exact match.
  • partial: The name is a partial match (The last name is the same but the first / middle name differ).

Enum: exact, partial

Example: exact
Standard error responses: 400 401 402 403 429 5XX See common error responses
Previous Court Check Multiple Next ADC Check Bulk