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.

Anything ASIC produces asynchronously is represented as an order: a document image PDF, an image-based charges extract, or an offline company name search. Each order moves from pending through processing to ready or delivered, or to failed if ASIC could not fulfil it. These endpoints let you fetch a single order, download its PDF once ready, and list your orders filtered by status, type and date. Reading and downloading orders is free; the fee was charged when the order was accepted. If you would rather not poll, the order.ready and order.failed webhooks deliver the same order object when the status changes. The purchasing guide explains how orders differ from purchased extracts.

GEThttps://api.asicapi.dev/v1/orders/{orderId}

GEThttps://api.asicapi.dev/v1/orders/{orderId}/download

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

How an order flows

Place the order

POST to an ordering endpoint such as /v1/documents/{documentNumber}/image-orders or /v1/companies/{id}/charges/extract-orders. The response is 202 Accepted with an order in status pending. Billing occurs at acceptance: the fee is charged when ASIC accepts the order, not when you download the result.

Wait for it to be ready

Poll GET /v1/orders/{orderId} until status is ready (web delivery) or delivered (email and post), or subscribe to the order.ready webhook. Document images usually take minutes; charges extracts and offline searches can take hours. A download requested before the order is ready returns order_not_ready (HTTP 409).

Download the result

When status is ready, fetch GET /v1/orders/{orderId}/download with your bearer token to receive the PDF. The download is available until downloadExpiresAt, 7 days after readyAt; afterwards it returns order_download_expired (HTTP 410) and a new order must be placed.

Path parameters

Prop

Type

Query parameters (list)

Prop

Type

Example request

Request

curl https://api.asicapi.dev/v1/orders/ord_01J9AJ4P7Q0R3S6T9V2W5X8Y \
  -H "Authorization: Bearer $ASICAPI_KEY"

Example response

Response

{
  "object": "order",
  "id": "ord_01J9AJ4P7Q0R3S6T9V2W5X8Y",
  "type": "document_image",
  "status": "ready",
  "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": "https://api.asicapi.dev/v1/orders/ord_01J9AJ4P7Q0R3S6T9V2W5X8Y/download",
  "downloadExpiresAt": "2026-09-11T03:21:40Z",
  "asicRequestIds": ["7331245"],
  "clientReference": "MATTER-4471",
  "failure": null,
  "createdAt": "2026-09-04T03:20:11Z",
  "readyAt": "2026-09-04T03:21:40Z",
  "deliveredAt": null,
  "meta": {
    "billable": false,
    "product": null,
    "requestId": "req_01J9AK2R5S8T1V4W"
  }
}

Downloading the PDF

When status is ready and delivery.method is web, fetch downloadUrl with the same bearer token. The response is application/pdf with a Content-Disposition filename built from the document numbers. Supplementary documents are appended to the same PDF.

Request

curl -L https://api.asicapi.dev/v1/orders/ord_01J9AJ4P7Q0R3S6T9V2W5X8Y/download \
  -H "Authorization: Bearer $ASICAPI_KEY" \
  -o 0E5123456.pdf

The first successful download sets deliveredAt and moves the order to delivered. The URL keeps working until downloadExpiresAt, 7 days after readyAt, and can be downloaded any number of times before then. After expiry it returns order_download_expired (HTTP 410) and a new order must be placed.

Listing orders

Request

curl "https://api.asicapi.dev/v1/orders?type=document_image&status=ready&createdAfter=2026-09-01T00:00:00Z" \
  -H "Authorization: Bearer $ASICAPI_KEY"

Response

{
  "object": "list",
  "data": [
    {
      "object": "order",
      "id": "ord_01J9AJ4P7Q0R3S6T9V2W5X8Y",
      "type": "document_image",
      "status": "ready",
      "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": "https://api.asicapi.dev/v1/orders/ord_01J9AJ4P7Q0R3S6T9V2W5X8Y/download",
      "downloadExpiresAt": "2026-09-11T03:21:40Z",
      "asicRequestIds": ["7331245"],
      "clientReference": "MATTER-4471",
      "failure": null,
      "createdAt": "2026-09-04T03:20:11Z",
      "readyAt": "2026-09-04T03:21:40Z",
      "deliveredAt": null
    },
    {
      "object": "order",
      "id": "ord_01J9A0M3N6P9Q2R5S8T1V4W7",
      "type": "document_image",
      "status": "ready",
      "documents": [
        {
          "documentNumber": "4E6677889",
          "formCode": "388",
          "formDescription": "Copy of financial statements and reports",
          "pages": null,
          "pageCount": 42,
          "large": false,
          "supplementaryDocuments": ["4E6677890"]
        }
      ],
      "delivery": {
        "method": "web",
        "email": null,
        "contactName": "ACCOUNTS PAYABLE",
        "contactPhone": "03 9000 0000",
        "recipient": null,
        "address": null,
        "instructions": null
      },
      "downloadUrl": "https://api.asicapi.dev/v1/orders/ord_01J9A0M3N6P9Q2R5S8T1V4W7/download",
      "downloadExpiresAt": "2026-09-09T22:05:13Z",
      "asicRequestIds": ["7329981"],
      "clientReference": null,
      "failure": null,
      "createdAt": "2026-09-02T22:03:47Z",
      "readyAt": "2026-09-02T22:05:13Z",
      "deliveredAt": null
    }
  ],
  "hasMore": false,
  "nextCursor": null,
  "totalCount": 2,
  "meta": {
    "billable": false,
    "product": null,
    "requestId": "req_01J9AK6X9Y2Z5A8B"
  }
}

Orders are listed newest first.

Order statuses

Status	Meaning	Next
`pending`	asicapi has accepted the order and is submitting it to ASIC. Billing has not yet been confirmed.	`processing`, `failed`
`processing`	ASIC has confirmed the order, returned `asicRequestIds` and billing details, and is producing the output.	`ready`, `delivered`, `failed`
`ready`	Web delivery only. The PDF has been collected from ASIC and `downloadUrl` is live. Fires `order.ready`.	`delivered`
`delivered`	The PDF has been downloaded at least once (web), or ASIC has confirmed dispatch by email or post. Terminal.	none
`failed`	ASIC rejected or could not complete the order. `failure` explains why. Nothing is billed for a failed order. Fires `order.failed`. Terminal.	none

Document images typically reach ready within a few minutes. Charges extracts and offline name searches are produced by ASIC in batches and can take several hours; offline searches are always delivered by email or webhook and never have a downloadUrl.

Response fields

Field	Type	Description
`object`	string	Always `order`.
`id`	string	Order id, prefixed `ord_`.
`type`	string	`document_image`, `charges_extract` or `offline_search`.
`status`	string	One of the statuses above.
`documents[]`	array	For `document_image` orders, the documents ordered: `documentNumber`, `formCode`, `formDescription`, `pages`, `pageCount`, `large`, `supplementaryDocuments[]`. Empty for other types.
`company`	object or null	For `charges_extract` orders, the company summary the extract was ordered for. Not present on `document_image` orders.
`search`	object or null	For `offline_search` orders, the search parameters submitted. Not present on other types.
`delivery.method`	string	`web`, `email` or `post`.
`delivery.email`	string or null	Email recipient.
`delivery.contactName`	string	Contact name sent to ASIC.
`delivery.contactPhone`	string	Contact phone sent to ASIC.
`delivery.recipient`	string or null	Postal recipient.
`delivery.address`	object or null	Postal address.
`delivery.instructions`	string or null	Postal delivery instructions.
`downloadUrl`	string or null	Download endpoint for web deliveries once `ready`. `null` for email and post, and before the order is ready.
`downloadExpiresAt`	timestamp or null	Expiry of `downloadUrl`, 7 days after `readyAt`.
`asicRequestIds[]`	string[]	ASIC's imaging request identifiers for tracing with the ASIC help desk. Empty while `pending`.
`clientReference`	string or null	`X-Client-Reference` supplied when the order was placed.
`failure`	object or null	Set when `status` is `failed`: `code` (an asicapi error code such as `document_not_imaged`), `message`, `asicCode` (ASIC's rejection code).
`createdAt`	timestamp	When the order was accepted.
`readyAt`	timestamp or null	When the output became available or was handed to email or post.
`deliveredAt`	timestamp or null	When delivery was confirmed.
`meta`	object	Reading and downloading orders is free: `billable` is `false` and `product` is `null`. The billing record lives on the 202 response that placed the order.
`hasMore`, `nextCursor`, `totalCount`	list fields	Present on the list form. See pagination.

Errors

Code	HTTP status	When
`order_not_found`	404	No order with this id exists, or it has been purged (orders are retained for 90 days).
`order_owner_mismatch`	403	The order was placed under a different account. Orders can only be read and downloaded by the account that created them.
`order_not_ready`	409	The download endpoint was called before `status` reached `ready`. Check `status` and retry, or subscribe to `order.ready`.
`order_download_expired`	410	The download endpoint was called after `downloadExpiresAt`. Place a new order.
`validation_error`	422	`status` or `type` is not a known value, `createdAfter` is not a valid timestamp, or `limit` is out of range.

Notes from the ASIC register

Ownership. ASIC only releases the output of an order to the client that requested it, and rejects collection attempts by any other client. asicapi enforces the same rule per account with order_owner_mismatch.
Collection window. ASIC holds completed output for collection for a limited time, typically 24 hours. asicapi collects it on your behalf as soon as ASIC signals it is ready and stores the PDF for 7 days, which is why downloadExpiresAt is 7 days after readyAt rather than 24 hours.
Tracing with ASIC. ASIC's imaging system assigns identifiers to each request it receives. asicRequestIds[] carries them so that, if an emailed or posted image never arrives, you or asicapi support can quote them to ASIC's document imaging help desk. Quoting the document numbers works too.
Supplementary documents. Documents lodged as supplements to an ordered document are included by ASIC at no extra charge. On web delivery they are appended to the PDF; on email they arrive as additional attachments.
Failures. ASIC can reject an order after accepting it, for example when an image turns out to be unreadable. Such orders end in failed with the reason in failure and are not billed. Orders that fail validation are rejected synchronously by the ordering endpoint and never appear here.
Webhooks. order.ready fires when a web-delivered order becomes downloadable and when an email or postal order is dispatched; order.failed fires on failure. The payload's data is the order object above. Configure endpoints in the dashboard; see webhooks for signature verification.
Sandbox. Sandbox orders move to ready within a minute, downloadUrl returns a sample PDF for company 009 136 109, and nothing is billed.

Track document image and extract orders

How an order flows

Place the order

Wait for it to be ready

Download the result

Path parameters

Query parameters (list)

Example request

Example response

Downloading the PDF

Listing orders

Order statuses

Response fields

Errors

Notes from the ASIC register

Order a document image

Purchasing guide

Company charges

Webhooks

Get a document

Pagination

Errors

On this page