Order an ASIC document image (PDF)
Order a PDF copy of any imaged ASIC document by document number, whole or by page range, for download, email or post, and receive an order to track delivery.
An ASIC document image is the scanned PDF of a form as it was lodged: the signed Form 484 that appointed a director, the Form 388 financial report, the Form 505 notice of a liquidator's appointment, the constitution lodged with a Form 201. The register tells you what changed; the image shows you the document that changed it. This endpoint places an order with ASIC for the image of one document, or up to ten in the batch form, and returns an order that you track until the PDF is ready to download or has been sent by email or post. Unlike a company or person extract, which comes back in the same call, an image order is asynchronous: ASIC produces the PDF after accepting the order. The purchasing guide compares the two.
https://api.asicapi.dev/v1/documents/{documentNumber}/image-ordershttps://api.asicapi.dev/v1/documents/image-ordersHow an order flows
Place the order
POST to one of the endpoints above. The response is 202 Accepted with an order object in status pending. ASIC bills the image at this point, when the order is accepted, not when you download it. Send an Idempotency-Key so a retry cannot place a second order.
Wait for it to be ready
Either poll GET /v1/orders/{orderId} until status is ready (web delivery) or delivered (email and post), or subscribe to the order.ready webhook and receive the order object when it changes. Document images usually take a few minutes. Calling the download endpoint early returns order_not_ready (HTTP 409).
Download the PDF
When status is ready, fetch GET /v1/orders/{orderId}/download with your bearer token. The download works until downloadExpiresAt, 7 days after readyAt; after that it returns order_download_expired (HTTP 410) and a new order is needed. Email and postal orders skip this step.
Path parameters
Prop
Type
Request body
Prop
Type
Send Content-Type: application/json. An Idempotency-Key header is strongly recommended: a retried request with the same key returns the original order instead of placing and billing a second one. An X-Client-Reference header (up to 30 characters) is stored on the order and shown on your invoice.
Example request
curl -X POST https://api.asicapi.dev/v1/documents/0E5123456/image-orders \
-H "Authorization: Bearer $ASICAPI_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 3b9d2f7a-order-0E5123456" \
-H "X-Client-Reference: MATTER-4471" \
-d '{
"pages": { "from": 1, "to": 4 },
"delivery": { "method": "web" }
}'Example response
The order is accepted with HTTP 202 and processed asynchronously. ASIC confirms that the request has been forwarded to its imaging system and provides billing details; the PDF itself arrives shortly afterwards.
{
"object": "order",
"id": "ord_01J9AJ4P7Q0R3S6T9V2W5X8Y",
"type": "document_image",
"status": "pending",
"documents": [
{
"documentNumber": "0E5123456",
"formCode": "484",
"formDescription": "Change to company details",
"pages": { "from": 1, "to": 4 },
"pageCount": 4,
"large": false,
"supplementaryDocuments": []
}
],
"delivery": {
"method": "web",
"email": null,
"contactName": "ACCOUNTS PAYABLE",
"contactPhone": "03 9000 0000",
"recipient": null,
"address": null,
"instructions": null
},
"downloadUrl": null,
"downloadExpiresAt": null,
"asicRequestIds": ["7331245"],
"clientReference": "MATTER-4471",
"failure": null,
"createdAt": "2026-09-04T03:20:11Z",
"readyAt": null,
"deliveredAt": null,
"meta": {
"billable": true,
"product": "document_image",
"quantity": 1,
"requestId": "req_01J9AJ4P7Q0R3S6T"
}
}Batch request
Order up to ten documents in one request. Every document in the batch shares one delivery instruction, and each is billed separately.
curl -X POST https://api.asicapi.dev/v1/documents/image-orders \
-H "Authorization: Bearer $ASICAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"documents": [
{ "documentNumber": "0E5123456", "pages": null },
{ "documentNumber": "4E6677889", "pages": { "from": 1, "to": 12 } }
],
"delivery": { "method": "email", "email": "records@example.com.au" }
}'{
"object": "order",
"id": "ord_01J9AJ8B2C5D8E1F4G7H0J3K",
"type": "document_image",
"status": "pending",
"documents": [
{
"documentNumber": "0E5123456",
"formCode": "484",
"formDescription": "Change to company details",
"pages": null,
"pageCount": 4,
"large": false,
"supplementaryDocuments": []
},
{
"documentNumber": "4E6677889",
"formCode": "388",
"formDescription": "Copy of financial statements and reports",
"pages": { "from": 1, "to": 12 },
"pageCount": 42,
"large": false,
"supplementaryDocuments": ["4E6677890"]
}
],
"delivery": {
"method": "email",
"email": "records@example.com.au",
"contactName": "ACCOUNTS PAYABLE",
"contactPhone": "03 9000 0000",
"recipient": null,
"address": null,
"instructions": null
},
"downloadUrl": null,
"downloadExpiresAt": null,
"asicRequestIds": ["7331246", "7331247"],
"clientReference": null,
"failure": null,
"createdAt": "2026-09-04T03:24:52Z",
"readyAt": null,
"deliveredAt": null,
"meta": {
"billable": true,
"product": "document_image",
"quantity": 2,
"requestId": "req_01J9AJ8B2C5D8E1F"
}
}The batch body fields are documents[] (1 to 10 entries of documentNumber and optional pages) and delivery (same shape as the single form). The whole batch is validated before ASIC is contacted; if any document fails validation the order is not placed.
Response fields
| Field | Type | Description |
|---|---|---|
object | string | Always order. |
id | string | Order id, prefixed ord_. Use it with GET /v1/orders/{orderId}. |
type | string | document_image. |
status | string | pending on creation. Moves through processing, ready (web) or delivered (email, post), or failed. See track orders for the transitions. |
documents[] | array | The documents ordered, in request order. |
documents[].documentNumber | string | The ASIC document number. |
documents[].formCode | string | Form code of the document. |
documents[].formDescription | string | Form title. |
documents[].pages | object or null | The page range requested, or null for the complete document. |
documents[].pageCount | integer | Total pages in ASIC's image, regardless of the range ordered. |
documents[].large | boolean | ASIC's large-document indicator from its billing confirmation. Large documents attract a higher statutory fee. |
documents[].supplementaryDocuments[] | string[] | Document numbers of supplementary documents ASIC will include at no extra charge, such as an XBRL file lodged with a financial report. |
delivery.method | string | web, email or post. |
delivery.email | string or null | Recipient address for email delivery. |
delivery.contactName | string | Contact name sent to ASIC. |
delivery.contactPhone | string | Contact phone sent to ASIC. |
delivery.recipient | string or null | Postal recipient, post only. |
delivery.address | object or null | Postal address, post only. |
delivery.instructions | string or null | Delivery instructions, post only. |
downloadUrl | string or null | Web delivery only. https://api.asicapi.dev/v1/orders/{orderId}/download once status is ready. null until then. |
downloadExpiresAt | timestamp or null | When the download URL stops working: 7 days after readyAt. |
asicRequestIds[] | string[] | Identifiers of the imaging requests ASIC generated for this order. Quote them, or the document numbers, to the ASIC help desk if an image is not received. |
clientReference | string or null | The X-Client-Reference header supplied with the request. |
failure | object or null | { "code", "message", "asicCode" } when status is failed, otherwise null. |
createdAt | timestamp | When the order was accepted. |
readyAt | timestamp or null | When the PDF became downloadable or was handed to email or post. |
deliveredAt | timestamp or null | When email or postal delivery was confirmed, or when the web PDF was first downloaded. |
meta.billable | boolean | true in production. false in the sandbox. |
meta.product | string | document_image. |
meta.quantity | integer | Number of document_image products billed, one per document ordered. |
meta.requestId | string | Echoes X-Request-Id. |
Errors
| Code | HTTP status | When |
|---|---|---|
document_number_invalid | 400 | A document number is not 9 characters or its first character is not a digit. |
duplicate_document_number | 400 | The same document number appears twice in a batch. |
page_range_invalid | 400 | Only one of pages.from and pages.to was supplied, to is less than from, from is less than 1, or the document does not contain the requested pages. |
delivery_invalid | 400 | method is not web, email or post; email delivery has a missing or malformed email; or post delivery is missing contactName, contactPhone, recipient, address or address.postcode. |
document_not_found | 404 | No publicly available ASIC document has this number. |
document_not_imaged | 422 | The document is not held in ASIC's imaging system (its page count is zero). |
document_too_large_for_delivery | 422 | The document exceeds the page limit for the chosen method: more than 50 pages for email, more than 500 for web. details.pageCount and details.maxPages explain the limit. |
validation_error | 422 | Batch documents[] is empty or has more than 10 entries, or the body is not valid JSON. |
idempotency_conflict | 409 | The Idempotency-Key was already used with a different body. |
asic_unavailable | 503 | The ASIC database is unavailable. |
Two further errors belong to the order once it exists and are returned by the order endpoints: order_not_ready (409) when the download is requested before status is ready, and order_download_expired (410) when it is requested after downloadExpiresAt.
Notes from the ASIC register
- Delivery limits. ASIC will not email a document of more than 50 pages, and will not deliver more than 500 pages through its web facility. Documents over 500 pages must be posted. Order a page range to bring a long document under the limit, or use
method: "post"for the full copy. - Page ranges. Start and end pages should only be supplied when part of the document is required. Supply both or neither; the complete document is provided when they are omitted. The range must exist in the document.
- Supplementary documents. Where supplementary documents have been lodged against a requested document, ASIC provides them automatically and at no additional charge. This is how XBRL data reaches you: XBRL files cannot be ordered by their own document number because they are delivered as an additional file with the original document.
- Many-to-many. ASIC splits an order into one or more internal imaging requests, and one imaging request can carry several documents.
asicRequestIds[]lists every identifier so that ASIC's document imaging help desk can trace delivery if an image does not arrive. Alternatively quote the document numbers. - Billing. ASIC bills per document image and marks large documents separately; asicapi reports one
document_imageproduct per document inmeta.quantityand the large flag on each document. The fee is incurred when ASIC accepts the order (the 202 response), not when you download the PDF, and an order that later fails is not billed. Reading the order and downloading the PDF are free. - Post delivery. Postal orders require a contact name, phone number, recipient, postal address and postcode. Delivery times depend on Australia Post and the order reaches
deliveredwhen ASIC confirms dispatch. - Imaged documents only. Images exist for imaged, publicly accessible ASIC documents. Check
imagedon get a document before ordering to avoiddocument_not_imaged. - Sandbox. With a test key, images can only be ordered for documents of ASIC's sample company 009 136 109. Orders complete within a minute and are never billable.
Related
Track orders
Poll order status, download the PDF and list past orders.
Purchasing guide
Free lookups, purchased extracts and asynchronous orders explained.
Get a document
Check page count and imaging status before you order.
Webhooks
Receive order.ready and order.failed events instead of polling.
Company documents
Find the document numbers a company has lodged.
Documents
What an ASIC document image is and when you need one.
Sandbox
Test ordering against ASIC's sample company.
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.
Track document image and extract orders
Check the status of ASIC document image orders, charges extract orders and offline name searches, download the finished PDF and list your past orders.