Workspace EventsList workspace events

List workspace events

GET/partners/workspace-events

Returns the events since the user last checked, or since a given time, oldest first.

HMAC signature + Bearer access token
Try this request

Query parameters

sincedatetimeoptional

Return events after this ISO 8601 date-time instead of the last check. Does not move the last-checked point.

eventTypesstringoptional

Comma-separated event types to return: `invoice.paid`, `invoice.payment_failed`, `bill.created`, `bank_feed.synced`. Does not move the last-checked point.

afterstringoptional

The `nextAfter` cursor from the previous page. Send it on its own.

limitintegeroptional

Events per page, 1–100. Defaults to 50.

Responses

200`window` says which window was read: `since_last_check`, `first_check`, `since`, or `after_event`. `windowStartsAt` is set for `first_check` and `since`; `previousCheckAt` is null on a first check.
400`since` is not an ISO 8601 date-time, `eventTypes` names an unknown type, or `limit` is outside 1–100.
401Missing or invalid HMAC signature, expired timestamp, or invalid Bearer token. Troubleshoot
403The credential does not have access to this workspace or resource. Troubleshoot
429Rate limit exceeded (100 requests per minute per user of each app, or 10,000 per minute per app). Retry after the Retry-After header. Troubleshoot
GEThttps://api.getcount.com/partners/workspace-events
Request
import crypto from 'node:crypto';

const BASE_URL = 'https://api.getcount.com';
const CLIENT_ID = process.env.COUNT_CLIENT_ID;
const CLIENT_SECRET = process.env.COUNT_CLIENT_SECRET;
const ACCESS_TOKEN = process.env.COUNT_ACCESS_TOKEN;

const method = 'GET';
const signingPath = '/workspace-events';
const timestamp = Math.floor(Date.now() / 1000).toString();
const bodyString = '';

const bodyHash = '';
const baseString = `${method}:${signingPath}:${timestamp}:${bodyHash}`;
const signature = crypto.createHmac('sha256', CLIENT_SECRET).update(baseString).digest('hex');

const response = await fetch(`${BASE_URL}/partners/workspace-events`, {
  method,
  headers: {
    'x-client-id': CLIENT_ID,
    'x-timestamp': timestamp,
    'x-signature': signature,
    Authorization: `Bearer ${ACCESS_TOKEN}`,
  },
});

console.log(await response.json());
Response · 200
{
  "status": "success",
  "message": "Success on reading workspace events",
  "data": {
    "events": [
      {
        "eventId": "5b1e7c3a-9d2f-4a6b-8e1c-7f3d2a9b4c10",
        "eventType": "invoice.paid",
        "occurredAt": "2026-03-12T09:41:07.000Z",
        "subjectType": "invoice",
        "subjectUuid": "f6a7b8c9-d0e1-2345-fabc-456789012345",
        "documentNumber": "INV-1042",
        "counterparty": {
          "type": "customer",
          "uuid": "dfa3219e-6af8-4c53-997a-037534f63a35"
        },
        "amount": {
          "decimalAmount": "1250.00",
          "currency": "USD"
        }
      },
      {
        "eventId": "8c2d4e6f-1a3b-4c5d-9e7f-2b4d6f8a0c21",
        "eventType": "bank_feed.synced",
        "occurredAt": "2026-03-12T11:05:44.000Z",
        "subjectType": "connection",
        "subjectUuid": "0e9d8c7b-6a5f-4e3d-2c1b-a09f8e7d6c5b",
        "newTransactionCount": 14
      }
    ],
    "hasMore": false,
    "nextAfter": null,
    "window": "since_last_check",
    "windowStartsAt": null,
    "previousCheckAt": "2026-03-11T17:20:00.000Z",
    "replayed": false,
    "readMarkerAdvanced": true
  }
}