List documents lodged by a company

List every form a company has lodged with ASIC by ACN, newest first, with document numbers, form codes, page counts and XBRL availability.

Company documents

Every notification a company makes to ASIC (a Form 484 change of details, a Form 201 application for registration, a Form 388 financial report, a Form 505 appointment of a liquidator) is recorded as a document with a nine character ASIC document number. This endpoint returns a company's document list, newest first, with each document's form code and description, dates received, processed and effective, page count, whether an image is available to order, and whether XBRL financial data accompanies it. It also lists documents lodged with state authorities before ASIC took over corporate registration in 1991. Use it to find the document number to pass to document details or an image order. This endpoint is a free lookup: it reads ASIC's live organisation details, needs no purchased extract, and always returns meta.billable: false. See the purchasing guide for which calls are free and which are billed.

GEThttps://api.asicapi.dev/v1/companies/{id}/documents

curl "https://api.asicapi.dev/v1/companies/004085616/documents?years=3&limit=3" \
  -H "Authorization: Bearer $ASICAPI_KEY"

Example response

Response

{
  "object": "list",
  "data": [
    {
      "object": "document",
      "documentNumber": "1E9876543",
      "formCode": "484",
      "formDescription": "Change to company details",
      "subForms": [
        { "code": "484A2", "description": "Cease officeholder" },
        { "code": "484E", "description": "Change to members register" }
      ],
      "receivedAt": "2023-11-24",
      "processedAt": "2023-11-27",
      "effectiveAt": "2023-11-20",
      "qualifier": null,
      "pageCount": 3,
      "imaged": true,
      "underRequisition": false,
      "xbrlAvailable": false,
      "xbrlDocumentNumber": null,
      "status": { "code": "PROC", "label": "Processed" },
      "priced": true
    },
    {
      "object": "document",
      "documentNumber": "1E5566778",
      "formCode": "388",
      "formDescription": "Copy of financial statements and reports",
      "subForms": [
        { "code": "388H", "description": "Large proprietary company that is not a disclosing entity" }
      ],
      "receivedAt": "2023-10-30",
      "processedAt": "2023-10-31",
      "effectiveAt": "2023-06-30",
      "qualifier": "FR 2023",
      "pageCount": 42,
      "imaged": true,
      "underRequisition": false,
      "xbrlAvailable": true,
      "xbrlDocumentNumber": "1E5566779",
      "status": { "code": "PROC", "label": "Processed" },
      "priced": true
    },
    {
      "object": "document",
      "documentNumber": "0E9988776",
      "formCode": "484",
      "formDescription": "Change to company details",
      "subForms": [
        { "code": "484B", "description": "Change of registered office address" }
      ],
      "receivedAt": "2023-02-02",
      "processedAt": null,
      "effectiveAt": "2023-02-01",
      "qualifier": null,
      "pageCount": 0,
      "imaged": false,
      "underRequisition": true,
      "xbrlAvailable": false,
      "xbrlDocumentNumber": null,
      "status": { "code": "REQN", "label": "Under requisition" },
      "priced": false
    }
  ],
  "hasMore": true,
  "nextCursor": "eyJyZWNlaXZlZEF0IjoiMjAyMy0wMi0wMiIsImRvY3VtZW50TnVtYmVyIjoiMEU5OTg4Nzc2In0",
  "totalCount": 11,
  "preAsicDocuments": [
    {
      "state": { "code": "VIC", "label": "Victoria" },
      "receivedAt": "1989-11-03",
      "formCode": "AR",
      "status": { "code": "PROC", "label": "Processed" }
    },
    {
      "state": { "code": "VIC", "label": "Victoria" },
      "receivedAt": "1988-10-28",
      "formCode": "AR",
      "status": { "code": "PROC", "label": "Processed" }
    }
  ],
  "meta": { "billable": false, "product": null, "requestId": "req_01J8ZKA3B4C5D6E" }
}

Response fields

Field	Type	Description
`object`	string	Always `list`.
`data[]`	document[]	Documents in reverse chronological order of the date ASIC received them.
`data[].object`	string	Always `document`.
`data[].documentNumber`	string	ASIC document number, 9 characters, first character numeric. Unique across the register.
`data[].formCode`	string	ASIC form code such as `484`, `201`, `388`, `505`.
`data[].formDescription`	string or null	ASIC's description of the form.
`data[].subForms[]`	object[]	Sub-form codes and descriptions for multi-part forms, for example the parts of a Form 484 that were completed.
`data[].receivedAt`	date	Date ASIC received the document.
`data[].processedAt`	date or null	Date ASIC processed the document onto the register. `null` while unprocessed.
`data[].effectiveAt`	date or null	Effective date of the change the document notifies, for example the date a director ceased or the balance date of a financial report.
`data[].qualifier`	string or null	Additional detail for certain forms: `AR 2001` for an annual return year, `FR 2023` for a financial report year.
`data[].pageCount`	integer	Number of pages in ASIC's image of the document. `0` when no image is currently available.
`data[].imaged`	boolean	`true` when `pageCount` is greater than 0 and the image can be ordered.
`data[].underRequisition`	boolean	`true` when ASIC has requisitioned the document (asked the lodging party to correct or complete it). The register may not yet reflect the change.
`data[].xbrlAvailable`	boolean	`true` when the document was lodged with accompanying XBRL financial data.
`data[].xbrlDocumentNumber`	string or null	Document number of the companion XBRL data document when `xbrlAvailable` is `true`. ASIC does not list the XBRL document separately.
`data[].status`	code or null	ASIC's form status code for the document, such as processed or under requisition. Passed through as ASIC records it.
`data[].priced`	boolean	ASIC's pricing indicator: whether ordering the document image attracts the standard image fee.
`hasMore`	boolean	`true` when more documents exist than were returned. Corresponds to ASIC's marker that there are further documents lodged by this company.
`nextCursor`	string or null	Cursor for the next page. asicapi uses ASIC's date range facility to fetch subsequent pages.
`totalCount`	integer	Total number of documents matching the filters.
`preAsicDocuments[]`	object[]	Documents lodged with a state or territory corporate affairs office before ASIC's inception in 1991. Not orderable as images.
`preAsicDocuments[].state`	code	State or territory the document was lodged in.
`preAsicDocuments[].receivedAt`	date or null	Date received by the state authority.
`preAsicDocuments[].formCode`	string or null	Form code under the state legislation of the day.
`preAsicDocuments[].status`	code or null	Document status as migrated.
`meta.billable`	boolean	`false`. The company document list is part of ASIC's organisation details and is not an extract.
`meta.product`	string or null	`null`.
`meta.requestId`	string	Request identifier.

Errors

Code	HTTP	When it occurs
`acn_invalid`	400	The number fails the ASIC check digit test.
`company_not_found`	404	No organisation with this identifier.
`abn_invalid`	400	The ABN fails its check digit test.
`abn_not_acn_based`	400	The ABN does not embed an ACN.
`abn_not_found`	404	No company matches the ACN embedded in the ABN.
`document_period_conflict`	400	Both `years` and a `from`/`to` date range were supplied. Use one or the other.
`document_date_range_invalid`	400	Only one of `from` and `to` was supplied, or `from` is later than `to`.
`document_list_unavailable`	422	ASIC does not provide a document list for this organisation type, for example a business name, name reservation or non-company name.
`validation_error`	422	`years` is negative, a date is malformed, or `limit` is out of range.
`unauthorized`	401	Missing or invalid API key.
`rate_limited`	429	Rate limit exceeded.
`asic_unavailable`	503	The ASIC register is offline.

Notes from the ASIC register

Which organisations have a document list. ASIC provides document lists for Australian proprietary and public companies (APTY, APUB), foreign companies (FNOS), registered Australian bodies (RACN), managed investment schemes (MISM), non-registered entities (NRET) and trusts (TRST). Business names and name reservations have no document list.
Ordering. Documents are returned in reverse chronological order of the date ASIC received them. effectiveAt may be earlier than receivedAt, since companies have up to 28 days to notify most changes.
Period filters. Choose either years or a from and to pair. If either date is supplied both must be, and from must not be later than to. With no filter all documents are listed.
Further documents. When ASIC's response is truncated it flags that there are further documents lodged by the company. asicapi turns that flag into hasMore and uses ASIC's date range facility to page through the remainder with cursor.
Images. When pageCount is 0 the document is not currently retrievable from ASIC's document imaging system and imaged is false. Documents lodged electronically are normally imaged within a day of processing. Order images with document image orders.
XBRL. Financial reports lodged with XBRL data (Form 388 and related forms) have xbrlAvailable: true. The XBRL data is a separate document identified by xbrlDocumentNumber; it does not appear as its own entry in the list.
Requisitioned documents. A document under requisition has been returned to the lodging party for correction. Its status reflects that, and changes it notifies may not yet appear on the register.
Pricing indicator. priced mirrors ASIC's pricing indicator for the document image. Supplementary documents lodged in response to a requisition are usually unpriced.
Pre-ASIC documents. Documents lodged with state corporate affairs commissions before 1 January 1991 are listed with the state and a state form code. Images of these documents are not available from ASIC.
Details, not extract. The document list is delivered from ASIC's organisation details and does not incur an extract fee. It is always live: every call reflects the register as it stands today.
Extracts carry their own document list. A purchased company extract also embeds a documents section, controlled by the documents.years and documents.limit options at purchase time. That embedded list is a snapshot at the extract's asOf time and never changes, whereas this endpoint is live and complete. Use the extract's list when you need the documents as they stood when the extract was produced, and this endpoint for everything else.

List documents lodged by a company

Company documents

Path parameters

Query parameters

Example request

Example response

Response fields

Errors

Notes from the ASIC register

ASIC documents

Get a document

Order a document image

Get a company

Purchase a company extract

External administration

Pagination

On this page