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.
https://api.asicapi.dev/v1/companies/{id}/extractshttps://api.asicapi.dev/v1/companies/{id}/extractshttps://api.asicapi.dev/v1/extracts/{id}https://api.asicapi.dev/v1/extractsOnly 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
type | Product | What it contains | Organisation types |
|---|---|---|---|
current | company_extract_current | Company details, current office holders, current addresses, current share classes, current members, external administration (when in effect), document list, contact address | APTY, APUB, RACN, FNOS, MISM |
historical | company_extract_historical | Everything in a current extract plus ceased office holders, former and future addresses, ceased share classes, former members, satisfied charges, annual returns and financial reports | APTY, APUB, RACN, FNOS, MISM |
relational | company_relationships | Roles the company holds in other organisations, licences it holds and shares it holds in other companies | APTY, APUB, RACN, FNOS |
Example 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.
{
"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
| Field | Type | Description |
|---|---|---|
object | string | Always extract. |
id | string | Extract identifier, prefixed ext_. Pass it to GET /v1/extracts/{id} or as the extract query parameter on any section endpoint. |
kind | string | company for every extract bought through this endpoint. Other kinds are person, register and weeklySummary. |
type | string | current, historical or relational. |
subject | object | Company summary of the organisation the extract describes. |
purchasedAt | timestamp | When the purchase was accepted and billed. |
asOf | timestamp | When ASIC produced the data. The extract is a snapshot at this moment and never changes afterwards. |
expiresAt | timestamp | 12 months after purchasedAt. After this the extract can no longer be read. |
disclaimer | string | ASIC's section 1274A notice, which must accompany any display of extract data. |
company | company | The 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. |
externalAdministration | object or null | Set 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 null | Satisfied charges in chronological order, same shape as the charges list. Only populated in a historical extract; null otherwise. |
documents | object or null | The 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.hasMore | boolean | true when documents.limit truncated the list. The complete list is always available from the free document list endpoint. |
annualReturns[] | annualReturn[] or null | Annual 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 null | Financial report periods with balance dates, due dates, AGM dates and the lodged Form 388. Only populated in a historical extract; null otherwise. |
contactAddress | address or null | The 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.billable | boolean | true on the purchase response (false in the sandbox). false whenever the extract is read back. |
meta.product | string | company_extract_current, company_extract_historical or company_relationships on the purchase response; null on reads. |
meta.requestId | string | Request 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.
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.
{
"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.
curl -X POST https://api.asicapi.dev/v1/companies/001000004/extracts \
-H "Authorization: Bearer $ASICAPI_KEY" \
-H "Content-Type: application/json" \
-d '{ "type": "relational" }'{
"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
| Code | HTTP | When it occurs |
|---|---|---|
acn_invalid | 400 | {id} is 9 digits but fails the ASIC check digit test. |
company_not_found | 404 | No organisation with this ACN, ARBN or ARSN exists. |
abn_and_acn_supplied | 400 | Both an ABN and an ACN were supplied for the same request. |
abn_invalid | 400 | {id} is 11 digits but fails the ABN check digit test. |
abn_not_acn_based | 400 | The ABN is valid but does not embed an ACN, so it cannot identify a company. |
abn_not_found | 404 | No company matches the ACN embedded in the ABN, or that company has no ABN recorded. |
extract_type_invalid | 400 | type is not current, historical or relational. |
extract_unavailable_for_type | 422 | ASIC 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_data | 404 | type is relational and the organisation holds no roles, licences or shareholdings on the register. Not billed. |
validation_error | 422 | documents.years or documents.limit is negative, or documents was supplied with type: relational. |
product_not_enabled | 403 | The extract product is not enabled for your account. |
idempotency_conflict | 409 | The Idempotency-Key was reused with a different body. |
unauthorized | 401 | Missing or invalid API key. |
rate_limited | 429 | Rate limit exceeded. |
asic_unavailable | 503 | The ASIC register is offline. Nothing was billed. |
Notes from the ASIC register
- A snapshot, not a subscription. ASIC produces the extract at
asOfand 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 passextract. - Retention. Extracts are retained for 12 months from
purchasedAt. Reading an expired extract returnsextract_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 forAPTY,APUB,RACNandFNOSonly. 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.yearsis the primary control: omit it for all years, or set0for no embedded document list.documents.limitis 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.registeredCharityistrue, 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
chargeslists 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.billableisfalse, and names are replaced with placeholders such asFAMILY 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.
https://api.asicapi.dev/v1/companies/{id}/extractsPath parameters
Prop
Type
Query parameters
Prop
Type
Example request
curl https://api.asicapi.dev/v1/companies/004085616/extracts \
-H "Authorization: Bearer $ASICAPI_KEY"Example 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
| Field | Type | Description |
|---|---|---|
object | string | Always list. |
data[] | extractSummary[] | Extract summaries, most recently purchased first. Expired extracts are not listed. |
data[].object | string | Always extractSummary. |
data[].id | string | Extract identifier. |
data[].kind | string | Always company on this endpoint. |
data[].type | string | current, historical or relational. |
data[].subject | object | Company summary of the organisation. |
data[].purchasedAt | timestamp | When the extract was purchased. |
data[].asOf | timestamp | When ASIC produced the data. |
data[].expiresAt | timestamp | When the extract stops being readable. |
hasMore | boolean | Whether another page exists. |
nextCursor | string or null | Cursor for the next page. |
totalCount | integer | Number of unexpired extracts you hold for this company. |
meta.billable | boolean | Always false. |
meta.product | string or null | Always null. |
meta.requestId | string | Request 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.
https://api.asicapi.dev/v1/extracts/{id}Path parameters
Prop
Type
Example 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:
{
"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.
https://api.asicapi.dev/v1/extractsQuery parameters
Prop
Type
Example request
curl "https://api.asicapi.dev/v1/extracts?kind=company&subject=004085616&type=current" \
-H "Authorization: Bearer $ASICAPI_KEY"Example 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)
| Code | HTTP | When it occurs |
|---|---|---|
extract_not_found | 404 | No extract with this id exists on your account. |
extract_expired | 410 | The extract is older than 12 months and is no longer readable. Purchase a new one. |
extract_owner_mismatch | 403 | The extract belongs to a different account. |
acn_invalid | 400 | On the company shortcut, {id} fails the ASIC check digit test. |
company_not_found | 404 | On the company shortcut, no organisation with this identifier exists. |
validation_error | 422 | Unknown kind, type or subject format, or limit out of range. |
unauthorized | 401 | Missing or invalid API key. |
rate_limited | 429 | Rate limit exceeded. |
Related
Purchasing
Free lookups, purchased extracts and asynchronous orders explained.
Company extracts
Current versus historical extracts and what each section contains.
Get a company
The free company record: identity, status and dates without an extract.
Office holders
Read directors, secretaries and administrators from the extract you hold.
Company members
Read the top 20 shareholders per class from the extract you hold.
Company relationships
Read a relational extract: roles, licences and shareholdings in other companies.
Company documents
The free, always live document list.
Errors
The extract_required, extract_not_found and extract_expired codes.
Get a company by ACN, ABN, ARBN or ARSN
Look up an Australian company record on the ASIC register by ACN, ABN, ARBN or ARSN for free: name, type, class, status, registration and review dates.
List company office holders
List the current and former directors, secretaries, liquidators, administrators and other office holders of an Australian company by ACN from the ASIC register.