asicapidocs

Purchase a company extract

Buy a current, historical or relational ASIC company extract by ACN with one POST, then read office holders, members and more for free for 12 months.

Company extracts

An ASIC company extract is the official snapshot of a company's register record: its office holders (directors, secretaries, liquidators), registered office and principal place of business, share capital, members, external administration status, satisfied charges, document list, annual returns and financial reports. On the ASIC register those sections do not exist as separate lookups; they are only produced as part of an extract issued under section 1274A of the Corporations Act 2001, and ASIC charges a fee for each one. asicapi mirrors that model. You purchase an extract with a single POST, receive the complete extract in the same response, and the extract is stored against your account for 12 months so that every subsequent read, whether through GET /v1/extracts/{id} or the section endpoints such as office holders and members, is free. The purchasing guide explains the three tiers of free lookups, purchased extracts and asynchronous orders.

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

Only the POST is billable

POST /v1/companies/{id}/extracts is the only call on this page that incurs an ASIC fee. Every GET, including the section endpoints that read from an extract, returns meta.billable: false. To see changes lodged since you purchased, purchase again; nothing refreshes automatically.

Purchase an extract

Path parameters

Prop

Type

Request body

Prop

Type

Extract types

typeProductWhat it containsOrganisation types
currentcompany_extract_currentCompany details, current office holders, current addresses, current share classes, current members, external administration (when in effect), document list, contact addressAPTY, APUB, RACN, FNOS, MISM
historicalcompany_extract_historicalEverything in a current extract plus ceased office holders, former and future addresses, ceased share classes, former members, satisfied charges, annual returns and financial reportsAPTY, APUB, RACN, FNOS, MISM
relationalcompany_relationshipsRoles the company holds in other organisations, licences it holds and shares it holds in other companiesAPTY, APUB, RACN, FNOS

Example request

Request
curl -X POST https://api.asicapi.dev/v1/companies/004085616/extracts \
  -H "Authorization: Bearer $ASICAPI_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 7d1f3a9c-extract-004085616" \
  -d '{ "type": "current", "documents": { "years": 5, "limit": 3 } }'

Example response

The extract is returned with HTTP 201. The same object is returned by GET /v1/extracts/{id} for the next 12 months.

Response
{
  "object": "extract",
  "id": "ext_01J9AB3K7Q2XM4",
  "kind": "company",
  "type": "current",
  "subject": {
    "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
  },
  "purchasedAt": "2026-09-04T03:12:44Z",
  "asOf": "2026-09-04T03:12:41Z",
  "expiresAt": "2027-09-04T03:12:44Z",
  "disclaimer": "This extract contains information derived from the Australian Securities and Investments Commission's (ASIC) database under section 1274A of the Corporations Act 2001. Please advise ASIC of any error which you may identify.",
  "company": {
    "object": "company",
    "id": "004085616",
    "acn": "004085616",
    "formatted": "004 085 616",
    "numberType": { "code": "ACN", "label": "Australian Company Number" },
    "abn": "53004085616",
    "name": "ACME WIDGETS PTY LTD",
    "nameStartDate": "2004-03-12",
    "type": { "code": "APTY", "label": "Australian Proprietary Company" },
    "class": { "code": "LMSH", "label": "Limited By Shares" },
    "subClass": { "code": "PROP", "label": "Proprietary Company" },
    "status": { "code": "REGD", "label": "Registered" },
    "registrationDate": "1948-07-06",
    "reviewDate": "2026-07-06",
    "deregistration": null,
    "stateOfRegistration": { "code": "VIC", "label": "Victoria" },
    "placeOfRegistration": "VICTORIA",
    "previousStateNumber": "C0123456X",
    "controllingJurisdiction": { "code": "ASIC", "label": "Australian Securities and Investments Commission" },
    "governanceType": null,
    "disclosingEntity": false,
    "registeredCharity": false,
    "principalPlace": { "locality": "MELBOURNE", "state": "VIC", "postcode": "3000" },
    "formerNames": [
      {
        "name": "ACME WIDGET COMPANY PTY LTD",
        "from": "1948-07-06",
        "to": "2004-03-12",
        "sourceDocument": { "documentNumber": "0E1122334", "qualifier": null }
      }
    ],
    "schemeCategories": [],
    "satisfiedChargesExtractSize": "small"
  },
  "officeholders": [
    {
      "object": "officeholder",
      "role": { "code": "DR", "label": "Director" },
      "status": { "code": "C", "label": "Current" },
      "appointedAt": "2015-02-01",
      "ceasedAt": null,
      "party": {
        "type": "person",
        "person": { "familyName": "SMITH", "givenNames": ["JANE", "LOUISE"], "formatted": "JANE LOUISE SMITH" },
        "birth": { "date": "1975-04-03", "locality": "MELBOURNE", "stateOrCountry": "VIC" },
        "organisation": null
      },
      "address": {
        "careOf": null,
        "line1": null,
        "street": "8 ORCHARD AVENUE",
        "locality": "KEW",
        "state": "VIC",
        "postcode": "3101",
        "country": "AUSTRALIA"
      },
      "sourceDocument": { "documentNumber": "0E5123456", "qualifier": null },
      "cessationDocuments": [],
      "court": null
    },
    {
      "object": "officeholder",
      "role": { "code": "SR", "label": "Secretary" },
      "status": { "code": "C", "label": "Current" },
      "appointedAt": "2019-08-19",
      "ceasedAt": null,
      "party": {
        "type": "person",
        "person": { "familyName": "TAN", "givenNames": ["WEI", "MING"], "formatted": "WEI MING TAN" },
        "birth": { "date": "1982-11-30", "locality": "SINGAPORE", "stateOrCountry": "SINGAPORE" },
        "organisation": null
      },
      "address": {
        "careOf": null,
        "line1": "UNIT 4",
        "street": "21 STATION STREET",
        "locality": "BOX HILL",
        "state": "VIC",
        "postcode": "3128",
        "country": "AUSTRALIA"
      },
      "sourceDocument": { "documentNumber": "0E7788990", "qualifier": null },
      "cessationDocuments": [],
      "court": null
    }
  ],
  "addresses": [
    {
      "object": "address",
      "type": { "code": "RG", "label": "Registered Office" },
      "status": { "code": "C", "label": "Current" },
      "from": "2018-01-15",
      "to": null,
      "address": {
        "careOf": "C/- EXAMPLE ACCOUNTANTS",
        "line1": "LEVEL 3",
        "street": "12 EXAMPLE STREET",
        "locality": "MELBOURNE",
        "state": "VIC",
        "postcode": "3000",
        "country": "AUSTRALIA"
      },
      "sourceDocument": { "documentNumber": "0E5123456", "qualifier": null }
    },
    {
      "object": "address",
      "type": { "code": "PA", "label": "Principal Place of Business" },
      "status": { "code": "C", "label": "Current" },
      "from": "2015-06-01",
      "to": null,
      "address": {
        "careOf": null,
        "line1": "UNIT 7",
        "street": "45 INDUSTRIAL DRIVE",
        "locality": "DANDENONG SOUTH",
        "state": "VIC",
        "postcode": "3175",
        "country": "AUSTRALIA"
      },
      "sourceDocument": { "documentNumber": "7E1234567", "qualifier": "AR 2015" }
    }
  ],
  "shareCapital": [
    {
      "object": "shareClass",
      "classCode": "ORD",
      "classTitle": "ORDINARY",
      "status": { "code": "C", "label": "Current" },
      "sharesIssued": 1000,
      "amountPaid": "1000.00",
      "amountDue": "0.00",
      "sourceDocument": { "documentNumber": "0E5123456", "qualifier": null }
    }
  ],
  "members": [
    {
      "object": "shareholding",
      "classCode": "ORD",
      "numberHeld": 500,
      "beneficiallyOwned": true,
      "fullyPaid": true,
      "status": { "code": "C", "label": "Current" },
      "jointHolding": false,
      "holders": [
        {
          "party": {
            "type": "organisation",
            "person": null,
            "birth": null,
            "organisation": {
              "number": "001000004",
              "numberType": { "code": "ACN", "label": "Australian Company Number" },
              "name": "ACME HOLDINGS LIMITED",
              "abn": "51001000004"
            }
          },
          "address": {
            "careOf": null,
            "line1": "LEVEL 20",
            "street": "1 EXAMPLE PLACE",
            "locality": "SYDNEY",
            "state": "NSW",
            "postcode": "2000",
            "country": "AUSTRALIA"
          }
        }
      ],
      "sourceDocument": { "documentNumber": "0E5123456", "qualifier": null }
    },
    {
      "object": "shareholding",
      "classCode": "ORD",
      "numberHeld": 300,
      "beneficiallyOwned": false,
      "fullyPaid": true,
      "status": { "code": "C", "label": "Current" },
      "jointHolding": false,
      "holders": [
        {
          "party": {
            "type": "person",
            "person": { "familyName": "SMITH", "givenNames": ["JANE", "LOUISE"], "formatted": "JANE LOUISE SMITH" },
            "birth": null,
            "organisation": null
          },
          "address": {
            "careOf": null,
            "line1": null,
            "street": "8 ORCHARD AVENUE",
            "locality": "KEW",
            "state": "VIC",
            "postcode": "3101",
            "country": "AUSTRALIA"
          }
        }
      ],
      "sourceDocument": { "documentNumber": "0E5123456", "qualifier": null }
    }
  ],
  "externalAdministration": null,
  "charges": null,
  "documents": {
    "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
      }
    ],
    "preAsicDocuments": [],
    "hasMore": true
  },
  "annualReturns": null,
  "financialReports": null,
  "contactAddress": {
    "object": "address",
    "type": { "code": "CC", "label": "Contact Address for ASIC use only" },
    "status": { "code": "C", "label": "Current" },
    "from": "2018-01-15",
    "to": null,
    "address": {
      "careOf": "C/- EXAMPLE ACCOUNTANTS",
      "line1": "PO BOX 1234",
      "street": null,
      "locality": "MELBOURNE",
      "state": "VIC",
      "postcode": "3001",
      "country": "AUSTRALIA"
    },
    "sourceDocument": { "documentNumber": "0E5123456", "qualifier": null }
  },
  "meta": { "billable": true, "product": "company_extract_current", "requestId": "req_01J9AB3K7Q2XM5" }
}

Response fields

FieldTypeDescription
objectstringAlways extract.
idstringExtract identifier, prefixed ext_. Pass it to GET /v1/extracts/{id} or as the extract query parameter on any section endpoint.
kindstringcompany for every extract bought through this endpoint. Other kinds are person, register and weeklySummary.
typestringcurrent, historical or relational.
subjectobjectCompany summary of the organisation the extract describes.
purchasedAttimestampWhen the purchase was accepted and billed.
asOftimestampWhen ASIC produced the data. The extract is a snapshot at this moment and never changes afterwards.
expiresAttimestamp12 months after purchasedAt. After this the extract can no longer be read.
disclaimerstringASIC's section 1274A notice, which must accompany any display of extract data.
companycompanyThe full company object as documented on Get a company, without meta. null for relational extracts, which carry the subject in subject only.
officeholders[]officeholder[]Office holders in ASIC order. Same shape as the office holders list. A current extract holds current appointments only; a historical extract adds ceased ones. null for relational extracts.
addresses[]address[]Registered office, principal place of business and, for foreign companies, the registered addresses in Australia and in the place of incorporation. Same shape as addresses. Former and future dated addresses appear in historical extracts only. null for relational extracts.
shareCapital[]shareClass[]Share classes, same shape as share capital. Ceased classes appear in historical extracts only. Empty for companies limited by guarantee. null for relational extracts.
members[]shareholding[]Top 20 members per class, same shape as members. Former members appear in historical extracts only. null for relational extracts.
externalAdministrationobject or nullSet when the company's status is EXAD: status (the organisation status), appointees[] (office holders with external administration roles) and documents[] relating to the administration. See external administration. null for any other status and for relational extracts.
charges[]charge[] or nullSatisfied charges in chronological order, same shape as the charges list. Only populated in a historical extract; null otherwise.
documentsobject or nullThe embedded document list, controlled by documents.years and documents.limit. null for relational extracts.
documents.data[]document[]Documents newest first, same shape as the company documents list.
documents.preAsicDocuments[]object[]Documents lodged with a state authority before 1991 that fall within the requested period, each with state, receivedAt, formCode and status.
documents.hasMorebooleantrue when documents.limit truncated the list. The complete list is always available from the free document list endpoint.
annualReturns[]annualReturn[] or nullAnnual returns lodged up to 2003, most recent year first. Only populated in a historical extract; null otherwise. Shape documented on annual returns and financial reports.
financialReports[]financialReport[] or nullFinancial report periods with balance dates, due dates, AGM dates and the lodged Form 388. Only populated in a historical extract; null otherwise.
contactAddressaddress or nullThe contact address for ASIC use only, always the last section of the extract. null when the company has none and for relational extracts.
rolesHeld[]roleHeld[]Relational extracts only. Roles the company holds in other organisations. See relationships. Absent from current and historical extracts.
licences[]licence[]Relational extracts only. Licences held by the company.
shareholdings[]shareholding[]Relational extracts only. Shares the company holds in other companies, each with the issuing company summary.
meta.billablebooleantrue on the purchase response (false in the sandbox). false whenever the extract is read back.
meta.productstringcompany_extract_current, company_extract_historical or company_relationships on the purchase response; null on reads.
meta.requestIdstringRequest identifier.

Historical extract

A historical extract is the same object with "type": "historical" and product company_extract_historical. The sections that are null in a current extract are populated, and ceased records (status E) appear alongside current ones in officeholders, addresses, shareCapital and members.

Request
curl -X POST https://api.asicapi.dev/v1/companies/004085616/extracts \
  -H "Authorization: Bearer $ASICAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "type": "historical", "documents": { "years": 0 } }'

The following shows only the keys that differ from the current extract above. officeholders, addresses, shareCapital and members gain their ceased records; the three sections below become non-null.

Response (sections that differ)
{
  "object": "extract",
  "id": "ext_01J9AC5D8R3YN7",
  "kind": "company",
  "type": "historical",
  "charges": [
    {
      "object": "charge",
      "chargeNumber": "1234567",
      "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
      },
      "status": { "code": "SATF", "label": "Satisfied" },
      "type": { "code": "B", "label": "Both Fixed & Floating" },
      "registeredAt": "2005-03-14T02:15:00Z",
      "createdAt": "2005-03-10",
      "expiresAt": null,
      "satisfiedAt": "2011-08-01",
      "preAsicChargeNumber": null,
      "chargees": [
        {
          "party": {
            "type": "organisation",
            "person": null,
            "birth": null,
            "organisation": {
              "number": "000000019",
              "numberType": { "code": "ACN", "label": "Australian Company Number" },
              "name": "FIRST EXAMPLE BANK LIMITED",
              "abn": null
            }
          }
        }
      ],
      "documents": [
        {
          "object": "document",
          "documentNumber": "021234567",
          "formCode": "309",
          "formDescription": "Notification of details of a charge",
          "subForms": [],
          "receivedAt": "2005-03-11",
          "processedAt": "2005-03-14",
          "effectiveAt": null,
          "qualifier": null,
          "pageCount": 12,
          "imaged": true,
          "underRequisition": false,
          "xbrlAvailable": false,
          "xbrlDocumentNumber": null,
          "status": null,
          "priced": true
        }
      ]
    }
  ],
  "documents": { "data": [], "preAsicDocuments": [], "hasMore": false },
  "annualReturns": [
    {
      "object": "annualReturn",
      "year": "2002",
      "outstanding": false,
      "dueDate": "2003-01-31",
      "extendedDueDate": null,
      "agmDueDate": null,
      "extendedAgmDueDate": null,
      "agmHeldDate": null,
      "document": { "documentNumber": "7E1234599", "qualifier": "AR 2002" }
    }
  ],
  "financialReports": [
    {
      "object": "financialReport",
      "balanceDate": "2023-06-30",
      "dueDate": "2023-10-31",
      "agmDueDate": null,
      "extendedAgmDueDate": null,
      "agmHeldDate": null,
      "outstanding": "N",
      "document": {
        "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": null,
        "priced": true
      }
    }
  ],
  "meta": { "billable": true, "product": "company_extract_historical", "requestId": "req_01J9AC5D8R3YN8" }
}

Relational extract

A relational extract looks outward from the company. It has no company, officeholders, addresses, shareCapital, members, externalAdministration, charges, documents, annualReturns, financialReports or contactAddress keys; instead it carries rolesHeld, licences and shareholdings. Read it back through relationships.

Request
curl -X POST https://api.asicapi.dev/v1/companies/001000004/extracts \
  -H "Authorization: Bearer $ASICAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "type": "relational" }'
Response
{
  "object": "extract",
  "id": "ext_01J9AD7F2T5ZP1",
  "kind": "company",
  "type": "relational",
  "subject": {
    "acn": "001000004",
    "formatted": "001 000 004",
    "numberType": { "code": "ACN", "label": "Australian Company Number" },
    "name": "ACME HOLDINGS LIMITED",
    "type": { "code": "APUB", "label": "Australian Public Company" },
    "status": { "code": "REGD", "label": "Registered" },
    "abn": "51001000004",
    "registeredCharity": false
  },
  "purchasedAt": "2026-09-04T03:15:02Z",
  "asOf": "2026-09-04T03:15:00Z",
  "expiresAt": "2027-09-04T03:15:02Z",
  "disclaimer": "This extract contains information derived from the Australian Securities and Investments Commission's (ASIC) database under section 1274A of the Corporations Act 2001. Please advise ASIC of any error which you may identify.",
  "rolesHeld": [
    {
      "object": "roleHeld",
      "role": { "code": "UH", "label": "Ultimate Holding Company" },
      "status": { "code": "C", "label": "Current" },
      "appointedAt": "2010-07-01",
      "ceasedAt": 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
      },
      "address": null,
      "sourceDocument": { "documentNumber": "7E1234567", "qualifier": "AR 2010" }
    }
  ],
  "licences": [
    {
      "object": "licence",
      "type": { "code": "FL", "label": "Financial Services Licencee" },
      "status": { "code": "C", "label": "Current" },
      "licenceNumber": "234567",
      "licenceStatus": { "code": "APPR", "label": "Application approved and licence granted" },
      "from": "2004-03-11",
      "to": null,
      "address": {
        "careOf": null,
        "line1": "LEVEL 20",
        "street": "1 EXAMPLE PLACE",
        "locality": "SYDNEY",
        "state": "NSW",
        "postcode": "2000",
        "country": "AUSTRALIA"
      },
      "sourceDocument": { "documentNumber": "4E1212121", "qualifier": null }
    }
  ],
  "shareholdings": [
    {
      "object": "shareholding",
      "classCode": "ORD",
      "numberHeld": 500,
      "beneficiallyOwned": true,
      "fullyPaid": true,
      "status": { "code": "C", "label": "Current" },
      "jointHolding": false,
      "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
      },
      "address": {
        "careOf": null,
        "line1": "LEVEL 20",
        "street": "1 EXAMPLE PLACE",
        "locality": "SYDNEY",
        "state": "NSW",
        "postcode": "2000",
        "country": "AUSTRALIA"
      },
      "sourceDocument": { "documentNumber": "0E5123456", "qualifier": null }
    }
  ],
  "meta": { "billable": true, "product": "company_relationships", "requestId": "req_01J9AD7F2T5ZP2" }
}

Errors

CodeHTTPWhen it occurs
acn_invalid400{id} is 9 digits but fails the ASIC check digit test.
company_not_found404No organisation with this ACN, ARBN or ARSN exists.
abn_and_acn_supplied400Both an ABN and an ACN were supplied for the same request.
abn_invalid400{id} is 11 digits but fails the ABN check digit test.
abn_not_acn_based400The ABN is valid but does not embed an ACN, so it cannot identify a company.
abn_not_found404No company matches the ACN embedded in the ABN, or that company has no ABN recorded.
extract_type_invalid400type is not current, historical or relational.
extract_unavailable_for_type422ASIC does not issue this kind of extract for the organisation type. Current and historical extracts cover APTY, APUB, RACN, FNOS and MISM; relational extracts cover APTY, APUB, RACN and FNOS. Business names, name reservations, trusts and non-registered entities have no extract.
no_relational_data404type is relational and the organisation holds no roles, licences or shareholdings on the register. Not billed.
validation_error422documents.years or documents.limit is negative, or documents was supplied with type: relational.
product_not_enabled403The extract product is not enabled for your account.
idempotency_conflict409The Idempotency-Key was reused with a different body.
unauthorized401Missing or invalid API key.
rate_limited429Rate limit exceeded.
asic_unavailable503The ASIC register is offline. Nothing was billed.

Notes from the ASIC register

  • A snapshot, not a subscription. ASIC produces the extract at asOf and the stored copy never changes. A director appointed the next day will not appear until you purchase a new extract, which is billed again and receives a new id. Section endpoints always read the most recent extract you hold unless you pass extract.
  • Retention. Extracts are retained for 12 months from purchasedAt. Reading an expired extract returns extract_expired. Buying the same type for the same company twice in a day produces two separately billed extracts; the API does not de-duplicate company extracts.
  • Which organisations have extracts. ASIC issues current and historical extracts for Australian proprietary and public companies (APTY, APUB), registrable Australian bodies (RACN), foreign companies (FNOS) and managed investment schemes (MISM). Relational extracts are issued for APTY, APUB, RACN and FNOS only. Business names, name reservations, trusts and non-registered entities have no extract; their free record is all ASIC provides.
  • Disclaimer. Every extract carries ASIC's notice, returned in disclaimer: This extract contains information derived from the Australian Securities and Investments Commission's (ASIC) database under section 1274A of the Corporations Act 2001. Please advise ASIC of any error which you may identify. Display it wherever you present extract data.
  • Current versus historical. A current extract contains current records only. A historical extract adds ceased office holders, former and future dated addresses, ceased share classes, former members, satisfied charges, annual returns and financial reports. Charges are never included in a current extract. A historical extract costs more than a current one.
  • Document list controls. documents.years is the primary control: omit it for all years, or set 0 for no embedded document list. documents.limit is then applied to the documents selected by the period, which protects you from a very large extract for a company with a long lodgement history. Neither control affects the document lists inside the charges and external administration sections. The full document list is always free from company documents.
  • Ordering rules. Sections appear in ASIC's fixed order: company details, office holders, addresses, share capital, members, external administration, charges, documents, annual returns, financial reports and finally the contact address. Office holders are grouped by role in the sequence RG, RP, PA, RO, RN, CA, EO, DR, SR, LD, AA, AG, UH, RC, RM, PT, PQ, MQ, VQ, CQ, SM, CM, DM, OM, AQ, RF, RS, FE, CR, MC, AC, AD, BI, BM, BP, with current records before ceased records and ceased records in reverse chronological order of ceasing. Addresses are grouped by type with current before ceased. Charges are in chronological order of registration. Documents are in reverse chronological order of receipt. Annual returns and financial reports are most recent first.
  • Top 20 members. For each class of shares issued by a proprietary company, ASIC records the twenty members of the class ranked by shareholding, plus any other members holding the same number of shares as the twentieth. A ceased member in a historical extract may only have dropped out of the top twenty.
  • Registered Australian bodies. For type RACN, ASIC prints: The Corporations Act 2001 requires only that limited information be lodged for Registered Australian Bodies and it is recommended that a search be also conducted with the appropriate authority in its place of registration.
  • Registered charities. When subject.registeredCharity is true, ASIC requires the ACNC notice to be shown: Registered Charity. This company is registered as a charity with the Australian Charities and Not-for-Profits Commission (ACNC). For further information on the charity, including the address for service, details of responsible persons (for example company directors) and financial reports, search the Charities register at www.acnc.gov.au.
  • Secretaries. Appointing a secretary is optional for proprietary companies. Where a company has no secretary ASIC prints: Appointment of secretary is optional. In the event no secretary is appointed the director(s) assume the responsibilities under the Law.
  • Personal Property Securities Register. Since 30 January 2012 current security interests are registered on the PPSR at www.ppsr.gov.au; ASIC holds only satisfied charges, which is why charges lists satisfied charges only.
  • Contact address. The contact address for ASIC use only is not a service address and ASIC requires that it always appears as the last section of an extract.
  • Waiver tokens. Some state and territory name indexes charge for a search. Those searches return a waiverToken; pass it here when purchasing an extract for one of the results and the search fee is refunded. The token is single use and valid for 30 days.
  • Sandbox. With a test key the purchase succeeds, meta.billable is false, and names are replaced with placeholders such as FAMILY NAME, GIVEN NAME1.

List the extracts you hold for a company

A shortcut for GET /v1/extracts?kind=company&subject={id}. Returns summaries of every unexpired company extract you have purchased for the organisation, newest first, so you can decide whether to read an existing extract or buy a fresh one.

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

Path parameters

Prop

Type

Query parameters

Prop

Type

Example request

Request
curl https://api.asicapi.dev/v1/companies/004085616/extracts \
  -H "Authorization: Bearer $ASICAPI_KEY"

Example response

Response
{
  "object": "list",
  "data": [
    {
      "object": "extractSummary",
      "id": "ext_01J9AC5D8R3YN7",
      "kind": "company",
      "type": "historical",
      "subject": {
        "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
      },
      "purchasedAt": "2026-09-04T03:13:30Z",
      "asOf": "2026-09-04T03:13:27Z",
      "expiresAt": "2027-09-04T03:13:30Z"
    },
    {
      "object": "extractSummary",
      "id": "ext_01J9AB3K7Q2XM4",
      "kind": "company",
      "type": "current",
      "subject": {
        "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
      },
      "purchasedAt": "2026-09-04T03:12:44Z",
      "asOf": "2026-09-04T03:12:41Z",
      "expiresAt": "2027-09-04T03:12:44Z"
    }
  ],
  "hasMore": false,
  "nextCursor": null,
  "totalCount": 2,
  "meta": { "billable": false, "product": null, "requestId": "req_01J9AE2G4V6AQ3" }
}

Response fields

FieldTypeDescription
objectstringAlways list.
data[]extractSummary[]Extract summaries, most recently purchased first. Expired extracts are not listed.
data[].objectstringAlways extractSummary.
data[].idstringExtract identifier.
data[].kindstringAlways company on this endpoint.
data[].typestringcurrent, historical or relational.
data[].subjectobjectCompany summary of the organisation.
data[].purchasedAttimestampWhen the extract was purchased.
data[].asOftimestampWhen ASIC produced the data.
data[].expiresAttimestampWhen the extract stops being readable.
hasMorebooleanWhether another page exists.
nextCursorstring or nullCursor for the next page.
totalCountintegerNumber of unexpired extracts you hold for this company.
meta.billablebooleanAlways false.
meta.productstring or nullAlways null.
meta.requestIdstringRequest identifier.

Get an extract

Returns the complete extract exactly as it was purchased, for any kind: company, person, register or weekly summary. Reading is free and can be repeated as often as you like until expiresAt.

GEThttps://api.asicapi.dev/v1/extracts/{id}

Path parameters

Prop

Type

Example request

Request
curl https://api.asicapi.dev/v1/extracts/ext_01J9AB3K7Q2XM4 \
  -H "Authorization: Bearer $ASICAPI_KEY"

Example response

The body is the same extract object shown in the purchase example above, with one difference in meta:

Response (meta only)
{
  "meta": { "billable": false, "product": null, "requestId": "req_01J9AE4H7X8BR5" }
}

List all extracts you hold

Lists every unexpired extract on your account across all kinds, newest first. Use the filters to find, for example, every historical extract you hold for a particular company, or every person extract purchased this month.

GEThttps://api.asicapi.dev/v1/extracts

Query parameters

Prop

Type

Example request

Request
curl "https://api.asicapi.dev/v1/extracts?kind=company&subject=004085616&type=current" \
  -H "Authorization: Bearer $ASICAPI_KEY"

Example response

Response
{
  "object": "list",
  "data": [
    {
      "object": "extractSummary",
      "id": "ext_01J9AB3K7Q2XM4",
      "kind": "company",
      "type": "current",
      "subject": {
        "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
      },
      "purchasedAt": "2026-09-04T03:12:44Z",
      "asOf": "2026-09-04T03:12:41Z",
      "expiresAt": "2027-09-04T03:12:44Z"
    }
  ],
  "hasMore": false,
  "nextCursor": null,
  "totalCount": 1,
  "meta": { "billable": false, "product": null, "requestId": "req_01J9AE6J9Z0CS7" }
}

The response fields are the same as for the company shortcut above. data[].subject is a company summary for company extracts, a person match (id, name, birth) for person extracts, a register entry summary for register extracts, and { "summaryType", "weekStarting" } for weekly summaries.

Errors (read endpoints)

CodeHTTPWhen it occurs
extract_not_found404No extract with this id exists on your account.
extract_expired410The extract is older than 12 months and is no longer readable. Purchase a new one.
extract_owner_mismatch403The extract belongs to a different account.
acn_invalid400On the company shortcut, {id} fails the ASIC check digit test.
company_not_found404On the company shortcut, no organisation with this identifier exists.
validation_error422Unknown kind, type or subject format, or limit out of range.
unauthorized401Missing or invalid API key.
rate_limited429Rate limit exceeded.

On this page