eventBlocks | GraphQL reference

eventBlocks

returns [EventBlock!]!

List one entity's event blocks with optional filters.

Recent events first (occurred_at descending). Filter by status (captured is the unposted queue, committed the audit trail), source (quickbooks / schedule / manual), eventType, and isReconcilingItem — true returns the post-sync reconciliation worklist, committed events whose upstream payload changed after they were posted.

Arguments

Name	Type	Description
eventType	String	Filter to one event type, e.g. `invoice_issued`.
eventCategory	String	Filter on the event's category label.
eventClass	String	`economic` for business activity, `support` for evidence about it (balance readings, reconciliation sign-offs), `operational` for schedule obligations. A balance reading's amount is a balance, not a flow.
status	String	Filter by lifecycle state: `captured` is the unposted queue, `committed` the audit trail.
agentId	String	Filter to events involving one counterparty.
source	String	Filter by originating system: `quickbooks`, `schedule` or `manual`.
isReconcilingItem	Boolean	True returns the post-sync reconciliation worklist - committed events whose upstream payload changed after posting.
limit	Int	Maximum rows to return, 1-1000. Omit to use this field's own default; out of range raises `INVALID_PAGINATION`.
offset	Int	Rows to skip before returning, 0 or greater. Out of range raises `INVALID_PAGINATION`.
entityId	String	The entity whose books to read. Omit for the group parent.

Returns EventBlock

Field	Type	Description
id	String!	—
eventType	String!	—
eventCategory	String!	—
eventClass	String!	—
status	String!	—
occurredAt	DateTime!	—
effectiveAt	DateTime	—
dueDate	Date	—
source	String!	—
externalId	String	—
externalUrl	String	—
amount	Int	—
currency	String!	—
description	String	—
metadata	JSON!	—
isReconcilingItem	Boolean!	—
dimensionIds	[String!]!	—
agentId	String	—
resourceType	String	—
resourceElementId	String	—
replacedByEventId	String	—
replacesEventId	String	—
obligatedByEventId	String	—
dischargesEventId	String	—
documentId	String	—
createdAt	DateTime!	—
createdBy	String!	—
triggeredEntries	[LedgerJournalEntry!]!	—

Example

query

{ eventBlocks { id eventType eventCategory eventClass } }

curl

curl -X POST "https://api.robosystems.ai/extensions/$GRAPH_ID/graphql" \
  -H "X-API-Key: $ROBOSYSTEMS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ eventBlocks { id eventType eventCategory eventClass } }"}'