ASIC Extract

POST /api/v2/asic_extract operationId: asic_extract

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

Requests an ASIC company or person extract. The response confirms the job was queued and returns an api_reference. Poll GET /asic_extract/{api_reference} until the extract payload is ready.

Request scenarios

Company extract – set type to company, provide either an ABN or ACN, and choose an extract_type:
- current: Requests an ASIC Current Extract.
- historical: Requests an ASIC Current and Historical Extract.
- relational: Request an ASIC Relational Extract.
Person extract – set type to person and supply the person_id, search_id, legal name, and birth_date exactly as returned by /asic_extract_person_search. Linked identifiers from that search should be listed in additional_person_ids so the resulting extract stitches together all associated roles/shareholdings. The primary person_id must not appear inside additional_person_ids.

Sandbox dataset

The sandbox serves fictitious companies and people built to exercise specific scenarios: registered, deregistered, in administration, in liquidation, multiple directors, related entities and more. Every identifier, the extract types each one answers, and the linked people are listed in the ASIC Sandbox Data guide.

Request body

Content type application/json. Parameters describing the ASIC entity you wish to extract.

Field	Description
`type`required	string "company" for organisation extracts or "person" for individual extracts. Enum: `company`, `person` Example: `company`
`extract_type`required	string Company extracts accept `current`, `historical`, or `relational`. Person extracts accept `current` or `historical` only. Enum: `current`, `historical`, `relational` Example: `current`
`abn`	string or null Required when `type` is `company` and an ACN is not supplied. Provide 11 digits (whitespace ignored). Example: `32111111114`
`acn`	string or null Required when `type` is `company` and an ABN is not supplied. Provide 9 digits (whitespace ignored). Example: `111111114`
`person_id`	string or null Required for person extracts. Copy the `person_id` provided by `/asic_extract_person_search`. Example: `123456780`
`additional_person_ids`	array of strings or null Optional list of related ASIC person identifiers. Do not repeat the primary `person_id`. Use the additional IDs returned by `/asic_extract_person_search` (or derived from sandbox keys containing `\|`).
`search_id`	string or null Required for person extracts. Copy the `search_id` returned by `/asic_extract_person_search`. Example: `11223344`
`name`	string or null Required for person extracts. Uppercase legal name matching the search result. Example: `JOHN MICHAEL DOE`
`birth_date`	string (date) or null Required for person extracts. ISO `YYYY-MM-DD` date of birth taken from the search result. Example: `1980-05-15`

Responses

200

Extract request accepted.

application/json

Field Description

Field	Description
`message`	string Always `Ok` on success. Example: `Ok`
`function`	string The API function that handled the request. Example: `asic_extract`
`api_reference`	string (uuid) Audit reference for this extract request. Poll `/asic_extract/{api_reference}` to retrieve results. Example: `fe4291ca-d831-4760-96df-c9cb03b3cd95`

message

string

Always Ok on success.

Example: Ok

function

string

The API function that handled the request.

Example: asic_extract

api_reference

string (uuid)

Audit reference for this extract request. Poll /asic_extract/{api_reference} to retrieve results.

Example: fe4291ca-d831-4760-96df-c9cb03b3cd95

501

Summary extracts are not implemented.

application/json

Field Description

Field	Description
`message`	string Static error returned when `summary=true` is requested. Example: `Summary ASIC extracts are not supported yet.`

message

string

Static error returned when summary=true is requested.

Example: Summary ASIC extracts are not supported yet.

Standard error responses: 400 401 402 403 429 5XX See common error responses

Previous ASIC ID Check Next Retrieve ASIC Extract

Request body application/json

{
    "type": "company",
    "extract_type": "current",
    "abn": "32111111114",
    "acn": "111111114",
    "person_id": "123456780",
    "additional_person_ids": [
        "123456781"
    ],
    "search_id": "11223344",
    "name": "JOHN MICHAEL DOE",
    "birth_date": "1980-05-15"
}

Response

200 Extract request accepted.

{
    "message": "Ok",
    "function": "asic_extract",
    "api_reference": "fe4291ca-d831-4760-96df-c9cb03b3cd95"
}

400 Bad or missing input parameter shared error response

{
    "message": "string"
}

401 Unauthorized - The request is not authorized. shared error response

{
    "message": "API Key Inactive"
}

402 Insufficient Credit - Insufficient credit to process this request shared error response

{
    "message": "Insufficient Credit"
}

403 No access - No permission to process this request shared error response

{
    "message": "No access"
}

429 Rate limited - The request rate limit has been reached shared error response

{
    "message": "Rate limited"
}

501 Summary extracts are not implemented.

{
    "message": "Summary ASIC extracts are not supported yet."
}

5XX Internal error - Internal system error shared error response

{
    "message": "Internal error"
}