GET
/
entity
/
{id}
/
changes
Poll for change events for a watched entity.
curl --request GET \
  --url https://api.auo.com.au/v1/entity/{id}/changes \
  --header 'Authorization: Bearer <token>'
{
  "changes": [
    {
      "event_id": "<string>",
      "payload": "<string>",
      "created_at": "<string>"
    }
  ],
  "next_cursor": "<string>"
}
GET https://api.auo.com.au/v1/entity/{id}/changes?since={timestamp} The polling fallback for watch. If your infrastructure cannot receive inbound webhooks, poll this endpoint for the change events on a watched entity, along with their delivery status. Every event that a webhook would deliver is also readable here, so nothing is lost.

​
Request

​
id
string
required
The watched entity identifier (ABN or ACN).
​
since
string
required
An ISO-8601 timestamp. Returns events after this time, exclusive. Use the timestamp of the last event you saw to page forward. This parameter is required.
​
limit
integer
Optional. The maximum number of events to return in one page.

​
Response

Returns the entity’s change events in time order, each with its delivery_status and, where a webhook was attempted, the response code. Use the since cursor to page forward until the page is empty.
since is mandatory. A request without it returns a 400 with the message “since is required (an ISO-8601 timestamp)”.

​
Example

curl "https://api.auo.com.au/v1/entity/51824753556/changes?since=2026-07-01T00:00:00Z" \
  -H "Authorization: Bearer auo_sk_live_your_key"

​
Webhooks vs polling

Webhooks are the primary delivery mechanism: AUO POSTs a signed event to your URL as soon as a change is detected. Polling is the fallback for environments that cannot accept inbound requests, and a way to reconcile after an endpoint outage. A failed delivery (after AUO exhausts its retries) still remains readable here, so you can catch up without losing an event.

​
See also

Watch and webhooks

The primary, push-based delivery path and signature verification.

Authorizations

​
Authorization
string
header
required

Bearer token: auo_sk_test_... (sandbox) or auo_sk_live_... (live).

Path Parameters

​
id
string
required

The entity identifier (ABN or ACN) to retrieve changes for.

Query Parameters

​
since
string
required

Exclusive ISO 8601 cursor. Only events with created_at strictly after this value are returned. Pass 1970-01-01T00:00:00Z to retrieve all events from the beginning.

​
limit
integer
default:50

Maximum number of events to return. Defaults to 50, capped at 200.

Required range: x <= 200

Response

Paginated list of change events for the entity. An empty changes array means no events match the cursor and filters.

Paginated list of change events for a watched entity. Use next_cursor as the since parameter for the next page. A null next_cursor means there are no further pages.

​
changes
object[]
required

Ordered list of change events (ascending by created_at).

​
next_cursor
string | null
required

The created_at of the last row on this page, or null when this is the final page. Pass as the since query parameter to retrieve the next page.