asicapidocs

Get ASIC document details by document number

Look up any ASIC document number to get the form code, lodgement dates, page count, imaging status, related parties and the company it was lodged for.

Every form lodged with ASIC, from a Form 201 company registration to a Form 484 change of details or a Form 505 appointment of a liquidator, is given a 9-character ASIC document number. Company extracts, person extracts and weekly summaries all cite these numbers. This endpoint resolves a document number into its details: the form code and title, when ASIC received and processed it, how many pages the scanned image has, whether it is available to order, and the company and people the document relates to. Use it to validate a document number before ordering the image, or to discover which company a document belongs to when all you have is the number. It is a free lookup: ASIC charges only when you order the image, as explained in the purchasing guide.

GEThttps://api.asicapi.dev/v1/documents/{documentNumber}
GEThttps://api.asicapi.dev/v1/documents?numbers[]={documentNumber}

Path parameters

Prop

Type

Query parameters (batch form)

Prop

Type

Example request

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

Example response

Response
{
  "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,
  "company": {
    "acn": "004085616",
    "formatted": "004 085 616",
    "numberType": { "code": "ACN", "label": "Australian Company Number" },
    "name": "ACME WIDGETS PTY LTD",
    "type": { "code": "APTY", "label": "Australian Proprietary Company" },
    "status": { "code": "REGD", "label": "Registered" },
    "abn": "53004085616",
    "registeredCharity": false
  },
  "relatedParties": [
    {
      "type": "organisation",
      "person": null,
      "birth": null,
      "organisation": {
        "number": "004085616",
        "numberType": { "code": "ACN", "label": "Australian Company Number" },
        "name": "ACME WIDGETS PTY LTD",
        "abn": "53004085616"
      }
    },
    {
      "type": "person",
      "person": {
        "familyName": "SMITH",
        "givenNames": ["JANE", "LOUISE"],
        "formatted": "JANE LOUISE SMITH"
      },
      "birth": null,
      "organisation": null
    },
    {
      "type": "organisation",
      "person": null,
      "birth": null,
      "organisation": {
        "number": "001000004",
        "numberType": { "code": "ACN", "label": "Australian Company Number" },
        "name": "BLUE HARBOUR HOLDINGS PTY LTD",
        "abn": "71001000004"
      }
    }
  ],
  "meta": {
    "billable": false,
    "product": null,
    "requestId": "req_01J9AH1M4N7P0Q3R"
  }
}

Batch request

Look up as many as ten document numbers in one call. The response is a list whose items are either a document or, where ASIC rejected that particular number, an error entry, so one bad number does not fail the whole request.

Request
curl "https://api.asicapi.dev/v1/documents?numbers[]=0E5123456&numbers[]=4E6677889&numbers[]=9E0000001" \
  -H "Authorization: Bearer $ASICAPI_KEY"
Response
{
  "object": "list",
  "data": [
    {
      "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,
      "company": {
        "acn": "004085616",
        "formatted": "004 085 616",
        "numberType": { "code": "ACN", "label": "Australian Company Number" },
        "name": "ACME WIDGETS PTY LTD",
        "type": { "code": "APTY", "label": "Australian Proprietary Company" },
        "status": { "code": "REGD", "label": "Registered" },
        "abn": "53004085616",
        "registeredCharity": false
      },
      "relatedParties": [
        {
          "type": "organisation",
          "person": null,
          "birth": null,
          "organisation": {
            "number": "004085616",
            "numberType": { "code": "ACN", "label": "Australian Company Number" },
            "name": "ACME WIDGETS PTY LTD",
            "abn": "53004085616"
          }
        },
        {
          "type": "person",
          "person": {
            "familyName": "SMITH",
            "givenNames": ["JANE", "LOUISE"],
            "formatted": "JANE LOUISE SMITH"
          },
          "birth": null,
          "organisation": null
        }
      ]
    },
    {
      "object": "document",
      "documentNumber": "4E6677889",
      "formCode": "388",
      "formDescription": "Copy of financial statements and reports",
      "subForms": [],
      "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,
      "company": {
        "acn": "009136109",
        "formatted": "009 136 109",
        "numberType": { "code": "ACN", "label": "Australian Company Number" },
        "name": "NORTHERN RIVERS COMMUNITY FOUNDATION LTD",
        "type": { "code": "APUB", "label": "Australian Public Company" },
        "status": { "code": "REGD", "label": "Registered" },
        "abn": "27009136109",
        "registeredCharity": true
      },
      "relatedParties": [
        {
          "type": "organisation",
          "person": null,
          "birth": null,
          "organisation": {
            "number": "009136109",
            "numberType": { "code": "ACN", "label": "Australian Company Number" },
            "name": "NORTHERN RIVERS COMMUNITY FOUNDATION LTD",
            "abn": "27009136109"
          }
        }
      ]
    },
    {
      "object": "error",
      "documentNumber": "9E0000001",
      "error": {
        "type": "not_found_error",
        "code": "document_not_found",
        "message": "No publicly available ASIC document exists with document number 9E0000001.",
        "param": "numbers[2]",
        "asicCode": "DD51",
        "requestId": "req_01J9AH1M4N7P0Q3R",
        "docUrl": "https://asicapi.dev/docs/errors#document_not_found"
      }
    }
  ],
  "hasMore": false,
  "nextCursor": null,
  "totalCount": 3,
  "meta": {
    "billable": false,
    "product": null,
    "requestId": "req_01J9AH1M4N7P0Q3R"
  }
}

The batch call returns HTTP 200 whenever the request itself was valid, even if every item is an error entry. Request-level problems such as a malformed or duplicated number are returned as a normal error response with HTTP 400 and nothing is looked up.

Response fields

FieldTypeDescription
objectstringdocument for the single form. In the batch form the envelope is list and each item is document or error.
documentNumberstringThe 9-character ASIC document number, uppercase.
formCodestringASIC form code, for example 484, 388, 505. See ASIC form codes.
formDescriptionstringTitle of the form as ASIC describes it.
subForms[]arraySub-form or schedule codes and descriptions, for example 484A, 484E. Empty when the form has none.
receivedAtdateDate ASIC received the lodgement.
processedAtdate or nullDate ASIC processed it onto the register.
effectiveAtdate or nullEffective date of the change the document reports.
qualifierstring or nullYear qualifier for annual returns (AR 2019) and financial reports (FR 2025).
pageCountintegerNumber of pages in ASIC's document image. 0 when the image is not currently retrievable.
imagedbooleantrue when pageCount is greater than 0 and the document can be ordered.
underRequisitionbooleantrue when ASIC has requisitioned the document for correction.
xbrlAvailablebooleantrue when the document was lodged with XBRL financial data.
xbrlDocumentNumberstring or nullDocument number of the accompanying XBRL file when xbrlAvailable is true.
statusnullForm status is only supplied on company document lists; always null here.
pricednullThe pricing indicator is only supplied on company document lists; always null here.
companyobject or nullSummary of the company the document was lodged for, when ASIC identifies one among the related parties: acn, formatted, numberType, name, type, status, abn, registeredCharity. null for documents lodged against a person only.
relatedParties[]arrayEvery organisation and person ASIC has indexed against the document, in ASIC's order. The lodging company is usually first.
relatedParties[].typestringperson or organisation.
relatedParties[].personobject or nullName of a related person: familyName, givenNames[], formatted.
relatedParties[].birthnullASIC does not supply birth details on document lookups; always null.
relatedParties[].organisationobject or nullA related organisation: number, numberType (the heading ASIC gives the number, the number types table), name, abn.
data[].errorobjectBatch form only. Standard error object for a number ASIC rejected: type, code, message, param (the position in numbers[]), asicCode, requestId, docUrl.
hasMore, nextCursorboolean, nullBatch form only. Always false and null; at most ten items are returned.
totalCountintegerBatch form only. Number of items, equal to the number of document numbers requested.
metaobjectDocument lookups are free: billable is always false and product is null.

Errors

CodeHTTP statusWhen
document_number_invalid400A document number is not 9 characters or its first character is not a digit.
duplicate_document_number400The same number appears twice in numbers[].
validation_error422numbers[] is empty or has more than 10 entries.
document_not_found404No publicly available ASIC document has this number. In the batch form this appears as an error item.
document_not_imaged422The document exists but is not held in ASIC's document imaging system. Some lookups still return details with pageCount 0 instead; see the notes.
asic_unavailable503The ASIC database is unavailable.

Notes from the ASIC register

  • Public documents only. ASIC returns details for publicly accessible documents. Documents that are exempt from public inspection, or that were lodged with a state authority before ASIC existed and never migrated, return document_not_found.
  • Imaging. Document images are available for imaged, publicly accessible ASIC documents. Where ASIC's image page count is zero, the document is not currently available for retrieval and imaged is false; ordering it returns document_not_imaged. Documents lodged in the last day or two may show 0 until scanning completes.
  • XBRL files. Details of an XBRL document can only be obtained through the original document's number. Looking up the number in xbrlDocumentNumber directly returns document_not_found; the XBRL file is delivered together with the original when you order its image.
  • Organisation number headings. Organisations on the ASIC database are allocated a unique number whose heading depends on the type: ACN for Australian companies registered under the Corporations Act 2001, ARBN for registered bodies, ARSN for managed investment schemes, and plain Number for other entities. numberType carries the heading so you can display the number correctly.
  • Related parties are indexed names. ASIC indexes the parties named on the form, but the list is not a structured record of what changed. A Form 484 appointing a director will name the company and the director; the appointment date and role are on the company's office holders.
  • Free. Document detail lookups carry no ASIC fee, so call this endpoint as often as you like. The fee applies when you place an image order, which is charged when ASIC accepts the order. See the purchasing guide.
  • Sandbox. With a test key, only documents of ASIC's sample company 009 136 109 return details; other numbers return document_not_found.

On this page