---
title: "List workspace events · Workspace Events · COUNT Partner API"
description: "Returns the events since the user last checked, or since a given time, oldest first. GET /partners/workspace-events"
canonical: "https://developers.getcount.com/reference/workspace-events/list-workspace-events"
source: "https://developers.getcount.com/reference/workspace-events/list-workspace-events"
---
[Workspace Events](https://developers.getcount.com/reference/workspace-events) / List 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](https://developers.getcount.com/tools/try-it?method=GET&path=%2Fpartners%2Fworkspace-events)

[Invoices API](https://developers.getcount.com/reference/invoices) [Bills API](https://developers.getcount.com/reference/bills) [Connections API](https://developers.getcount.com/reference/connections) [Webhooks API](https://developers.getcount.com/reference/webhooks)

#### Query parameters

`since` datetime optional

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

`eventTypes` string optional

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

`after` string optional

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

`limit` integer optional

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.

`401` Missing or invalid HMAC signature, expired timestamp, or invalid Bearer token. [Troubleshoot](https://developers.getcount.com/getting-started/errors#error-401)

`403` The credential does not have access to this workspace or resource. [Troubleshoot](https://developers.getcount.com/getting-started/errors#error-403)

`429` Rate 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](https://developers.getcount.com/getting-started/errors#error-429)

GET `https://api.getcount.com/partners/workspace-events`

Request

```javascript
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

```json
{
  "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
  }
}
```
