asicapidocs

List documents lodged in relation to a person

List the ASIC forms lodged that name a person as a director, secretary, liquidator or member, with document numbers, form codes, dates and page counts.

Whenever a company appoints or removes an officer, changes a director's details or reports its members, it lodges a form with ASIC, and ASIC records the document against each person the form names. The person document list returns those lodgements: the ASIC document number, form code and title, the dates received, processed and effective, and whether a PDF image can be ordered. It gives you the paper trail behind a person's roles, and the document numbers you need for image orders. The endpoint reads from the most recent person extract you hold for the person and is free; the extract is purchased once with POST /v1/people/extracts, as explained in the purchasing guide.

GEThttps://api.asicapi.dev/v1/people/{personId}/documents

Path parameters

Prop

Type

Query parameters

Prop

Type

Example request

Request
curl "https://api.asicapi.dev/v1/people/prs_8f3k2m9q/documents" \
  -H "Authorization: Bearer $ASICAPI_KEY"

Example response

Response
{
  "object": "list",
  "extract": {
    "id": "ext_01J9AG8K1L4M7N2P",
    "type": "historical",
    "purchasedAt": "2026-09-04T03:12:44Z",
    "asOf": "2026-09-04T03:12:41Z"
  },
  "person": {
    "id": "prs_8f3k2m9q",
    "asicIdentifier": "012345678",
    "name": {
      "familyName": "SMITH",
      "givenNames": ["JANE", "LOUISE"],
      "formatted": "JANE LOUISE SMITH"
    },
    "birth": {
      "date": "1975-04-03",
      "locality": "MELBOURNE",
      "stateOrCountry": "VIC"
    },
    "formerName": null
  },
  "data": [
    {
      "object": "document",
      "documentNumber": "4E6677889",
      "formCode": "388",
      "formDescription": "Copy of financial statements and reports",
      "subForms": [
        { "code": "388", "description": "Copy of financial statements and reports" }
      ],
      "receivedAt": "2025-10-28",
      "processedAt": "2025-10-29",
      "effectiveAt": "2025-06-30",
      "qualifier": "FR 2025",
      "pageCount": 42,
      "imaged": true,
      "underRequisition": false,
      "xbrlAvailable": true,
      "xbrlDocumentNumber": "4E6677890",
      "status": null,
      "priced": null
    },
    {
      "object": "document",
      "documentNumber": "1E9876543",
      "formCode": "505",
      "formDescription": "Notification of appointment or cessation of an external administrator",
      "subForms": [],
      "receivedAt": "2023-03-22",
      "processedAt": "2023-03-23",
      "effectiveAt": "2023-03-20",
      "qualifier": null,
      "pageCount": 3,
      "imaged": true,
      "underRequisition": false,
      "xbrlAvailable": false,
      "xbrlDocumentNumber": null,
      "status": null,
      "priced": null
    },
    {
      "object": "document",
      "documentNumber": "0E5123456",
      "formCode": "484",
      "formDescription": "Change to company details",
      "subForms": [
        { "code": "484A", "description": "Change officeholder name or address" },
        { "code": "484E", "description": "Change to members register" }
      ],
      "receivedAt": "2015-02-09",
      "processedAt": "2015-02-10",
      "effectiveAt": "2015-02-01",
      "qualifier": null,
      "pageCount": 4,
      "imaged": true,
      "underRequisition": false,
      "xbrlAvailable": false,
      "xbrlDocumentNumber": null,
      "status": null,
      "priced": null
    },
    {
      "object": "document",
      "documentNumber": "7E1234567",
      "formCode": "370",
      "formDescription": "Notification by officeholder of resignation or retirement",
      "subForms": [],
      "receivedAt": "2014-12-02",
      "processedAt": "2014-12-04",
      "effectiveAt": "2014-11-30",
      "qualifier": null,
      "pageCount": 0,
      "imaged": false,
      "underRequisition": false,
      "xbrlAvailable": false,
      "xbrlDocumentNumber": null,
      "status": null,
      "priced": null
    }
  ],
  "hasMore": false,
  "nextCursor": null,
  "totalCount": 4,
  "meta": {
    "billable": false,
    "product": null,
    "requestId": "req_01J9AF5G8H2J9K3L"
  }
}

Response fields

FieldTypeDescription
objectstringAlways list.
extractobjectThe extract the documents were read from: id, type (current or historical), purchasedAt, asOf.
personobjectThe person the documents relate to: id, asicIdentifier, name, birth and formerName, as on get a person.
data[]arrayDocuments, newest receivedAt first.
data[].objectstringAlways document.
data[].documentNumberstring9-character ASIC document number. Pass it to get a document or order an image.
data[].formCodestringASIC form code, for example 484, 370, 505, 388. See ASIC form codes.
data[].formDescriptionstringTitle of the form.
data[].subForms[]arraySub-form or schedule codes with descriptions, for example 484A and 484E on a Form 484. Empty when the form has no schedules.
data[].receivedAtdateDate ASIC received the lodgement.
data[].processedAtdate or nullDate ASIC processed it onto the register.
data[].effectiveAtdate or nullEffective date of the change reported on the form.
data[].qualifierstring or nullFor annual returns and financial reports, the year the document covers, for example AR 2019 or FR 2025.
data[].pageCountintegerNumber of pages in ASIC's document image at the time of the extract. 0 means the image was not retrievable.
data[].imagedbooleanfalse when pageCount is 0. Only imaged documents can be ordered.
data[].underRequisitionbooleantrue when ASIC has requisitioned the lodging party to correct the document.
data[].xbrlAvailablebooleantrue when the financial report was lodged with XBRL data.
data[].xbrlDocumentNumberstring or nullDocument number of the accompanying XBRL file when xbrlAvailable is true.
data[].statusnullForm status codes are only supplied on company document lists; always null here.
data[].pricednullThe pricing indicator is only supplied on company document lists; always null here.
hasMorebooleanWhether another page exists.
nextCursorstring or nullCursor for the next page. See pagination.
totalCountintegerTotal documents for the person after filters.
metaobjectReads are free: billable is false and product is null.

Errors

CodeHTTP statusWhen
extract_required402You hold no person extract for this person. details.purchase carries the POST body that would satisfy the request.
extract_not_found404The extract query parameter names an extract that does not exist, belongs to another person or is not a person extract.
extract_expired410The extract is more than 12 months old. Purchase again.
extract_owner_mismatch403The extract named by extract was purchased under a different account.
person_not_found404The person id is malformed or was never returned by a search under your account.
document_date_range_invalid400from is later than to, or a date is not a valid ISO 8601 date.
validation_error422limit is out of range, formCode is not a known form code, or extract is malformed.

Notes from the ASIC register

  • Part of the extract. ASIC supplies a person's document list as part of the personal name extract, so the list you read here is the one captured at extract.asOf. Documents lodged since then appear only after you purchase a new extract. See the purchasing guide.
  • Which documents appear. ASIC lists documents that name the person in a role or as a member: appointment and cessation notices (Form 484 schedules, Form 370, Form 505), changes of personal details and financial reports lodged while the person was an officer. Documents lodged by the company that do not name the person are on the company document list, which is a free lookup.
  • Page counts and imaging. A pageCount of 0 means the document was not available from ASIC's document imaging system when the extract was taken. Older paper lodgements that were never scanned and very recent lodgements still being processed both show 0. Check the live figure with get a document before ordering; ordering an unimaged document returns document_not_imaged.
  • XBRL. Where a financial report was lodged with XBRL data, xbrlAvailable is true and the XBRL file's document number is given in xbrlDocumentNumber. The XBRL file is not listed as a separate entry and cannot be ordered by its own number; order the original document and the XBRL file is delivered with it.
  • Requisitioned documents. underRequisition marks documents ASIC has sent back for correction. The image is usually still available, but the register may not yet reflect the change.
  • Sub-forms. Multi-part forms such as the Form 484 carry a sub-form code for each schedule completed. The descriptions are ASIC's, and new sub-form codes appear without notice.

On this page