APIActivity

Get activity

GET
/public/v1/activity

Everything that changed in your company, newest first, one entry per operation (a save in Distru, an API call, a sync, an automation run, a job) however many records it changed, as the Activity page in Distru shows it. Each entry groups its rows by record. An operation that saved many rows shows its first 50, with truncated and the counts telling what was left out; the history of each record (GET /public/v1/record-history) has all of that record's rows. Plant additives, plant additive types and plant wastes have no history of their own, and nor do older shipment signatures (ORDER_SHIPMENT): their rows show only here.

By default this reads the last 7 days. changed_datetime reads another range, up to 366 days per call. ids[] reads the operations with those IDs whenever they ran: an entry's id is the same as in each record history it shows in, so ids[]=<id> gives the whole operation behind a record history entry.

Notes logged by hand show only in each record's history, as do some older entries read from the old activity log.

This is not for keeping a copy of your data in sync: use each type's list endpoint with updated_datetime (Incremental Sync). Entries sort by when their operation started, so one still running when you read a page can later appear behind it.

Entries are read from a copy of the database that can lag a few seconds behind, so a change made a moment ago may not show yet.

Results are paginated, 100 entries per page. A page can hold fewer entries, even none, while next_page is set: what you may not see is left out after the page is cut. Keep following next_page until it is null.

Required permission: none of its own. You see the records you may view in Distru, within your team restrictions, and only the fields you may see. API keys, MCP keys, webhooks, integrations, QuickBooks Online settings, company settings and scheduled reports never show.

Authorization

Bearer
headerAuthorizationBearer <token>

API token generated in Distru (Settings → Distru API). Send it on every request as Authorization: Bearer YOUR_API_TOKEN.

Query Parameters

changed_datetime?string

When the operations started, as an inclusive min,max range of ISO 8601 timestamps separated by a comma. Either bound may be left empty: min, reads from min until now, ,max the 365 days before max. A range can span at most 366 days; with an empty max, min may be up to 367 days ago, so a walk started a year back keeps working for a day. A min after max is a 400. Without it, the last 7 days, or with ids[], whenever those operations ran.

ids[]?array<string>

Only these operations, by an entry's id. Repeat the bracketed key once per ID. At most 200 IDs; an empty list is rejected. An ID of another company's operation, or of one you may see nothing of, matches nothing.

user_ids[]?array<string>

Only operations by these users, by user ID. Repeat the bracketed key once per ID. At most 200 IDs.

sources[]?array<>

Only operations from these sources. Repeat the bracketed key once per value. At most 200 values.

ops[]?array<>

Only operations that added (INSERT), removed (DELETE) or otherwise changed (UPDATE) a record. A record counts as added or removed only when its own row was; a change to its lines alone is an UPDATE. Repeat the bracketed key once per value. At most 200 values.

record_types[]?array<>

Only operations on these kinds of record; each entry then shows only their rows. Repeat the bracketed key once per value. At most 200 values.

page?string

Page selector. Page size is fixed by the server; paginate by following the next_page URL in each response rather than building page selectors yourself — it is null on the last page. next_page uses page[after]=<cursor>, an opaque token marking where the next page resumes; pass it back exactly as given, and only to the endpoint that issued it. This is seek-based, so every page stays fast no matter how deep you page.

Response Body

A page of activity

*/*
  1. response

A page of activity

data?array<>

Activity Entries

next_page?string

URL for the next page of results; null when there is no next page

Example Request
curl -X GET 'https://app.distru.com/public/v1/activity?sources%5B%5D=PUBLIC_API&sources%5B%5D=WEB'
Example Response
{  "data": [    {      "actor": {        "company_name": null,        "id": "00000000-0000-0000-0000-000000000c69",        "name": "FirstName3290 LastName3291"      },      "changed_datetime": "2026-11-18T16:10:41.817288Z",      "id": "afeca138-a50a-42ae-9e62-5037df88e3e0",      "impersonator": null,      "record_counts": [        {          "count": 1,          "type": "PRODUCT"        }      ],      "records": [        {          "events": [],          "id": "82ea68b4-10a6-4747-895c-a0e58db2f1a9",          "name": "Product 541",          "row_count": 1,          "rows": [            {              "entity": "PRODUCT",              "entity_label": "Product",              "fields": [                {                  "field": "is_active",                  "label": "Active",                  "legacy_text": null,                  "new_value": false,                  "old_value": true                }              ],              "op": "UPDATE",              "row_id": "82ea68b4-10a6-4747-895c-a0e58db2f1a9",              "row_label": null            }          ],          "truncated": false,          "type": "PRODUCT"        }      ],      "row_count": 1,      "source": "PUBLIC_API",      "source_detail": "Key 1",      "truncated": false    },    {      "actor": {        "company_name": null,        "id": "00000000-0000-0000-0000-000000000c69",        "name": "FirstName3290 LastName3291"      },      "changed_datetime": "2026-11-18T16:10:41.803275Z",      "id": "cc3f53c2-50f5-4169-b342-5e209035e591",      "impersonator": null,      "record_counts": [        {          "count": 3,          "type": "INVOICE"        }      ],      "records": [        {          "events": [],          "id": "00000000-0000-0000-0000-000000000034",          "name": "Invoice #40",          "row_count": 2,          "rows": [            {              "entity": "INVOICE",              "entity_label": "Invoice",              "fields": [                {                  "field": "external_notes",                  "label": "External notes",                  "legacy_text": null,                  "new_value": "E1",                  "old_value": null                }              ],              "op": "UPDATE",              "row_id": "00000000-0000-0000-0000-000000000034",              "row_label": null            },            {              "entity": "INVOICE_RECIPIENT_EMAIL",              "entity_label": "Recipient email",              "fields": [                {                  "field": "email",                  "label": "Email",                  "legacy_text": null,                  "new_value": null,                  "old_value": "[email protected]"                }              ],              "op": "DELETE",              "row_id": "1",              "row_label": "[email protected]"            }          ],          "truncated": false,          "type": "INVOICE"        },        {          "events": [],          "id": "00000000-0000-0000-0000-000000000035",          "name": "Invoice #41",          "row_count": 2,          "rows": [            {              "entity": "INVOICE",              "entity_label": "Invoice",              "fields": [                {                  "field": "external_notes",                  "label": "External notes",                  "legacy_text": null,                  "new_value": "E1",                  "old_value": null                }              ],              "op": "UPDATE",              "row_id": "00000000-0000-0000-0000-000000000035",              "row_label": null            }          ],          "truncated": true,          "type": "INVOICE"        },        {          "events": [            {              "message": "QuickBooks merged a payment into an existing payment because both applied the same credit memo to this invoice.",              "type": "QUICKBOOKS_PAYMENT_MERGED"            }          ],          "id": "00000000-0000-0000-0000-000000000036",          "name": "Invoice #42",          "row_count": 0,          "rows": [],          "truncated": false,          "type": "INVOICE"        }      ],      "row_count": 4,      "source": "WEB",      "source_detail": null,      "truncated": true    }  ],  "next_page": null}