---
title: "Workspace Events · Practice Manager API · COUNT Partner API"
description: "Read what changed in the workspace since the connecting user last checked: invoices paid, invoice payments that failed, bills added, and bank feed syncs that…"
canonical: "https://developers.getcount.com/practice-manager/reference/workspace-events"
source: "https://developers.getcount.com/practice-manager/reference/workspace-events"
---
Practice Manager API

# Workspace Events

Read what changed in the workspace since the connecting user last checked: invoices paid, invoice payments that failed, bills added, and bank feed syncs that brought in new transactions.

Last updated 2026-11-14

## Overview

GET /firm-partners/workspace/workspace-events answers "what happened since I last checked?". COUNT remembers where each user last read up to, per partner app, so a plain call returns only the events after that point (oldest first) and moves the point forward.

Events carry ids and figures only — no names, memos, or descriptions. Read the record itself with the invoice, bill, or connection routes, passing `subjectUuid`.

## Key concepts

### The last-checked point

A plain call returns the events after the user's last check and remembers this check for next time. The very first check, or one after more than 30 days away, covers the last 7 days. The log keeps 30 days of events.

### Reads that do not move the point

`since` (an ISO 8601 date-time, for "since Monday") and `eventTypes` read the log without moving the last-checked point. `readMarkerAdvanced` in the response says whether a call moved it.

### Paging

When `hasMore` is true, call again with only `after` set to the returned `nextAfter`. The next page keeps the first page's `eventTypes` and whether it moves the point. A read with the same `after` always returns the same page.

### Safe retries

Repeating a plain call within 2 minutes returns the same events again with `replayed: true`, so a retried call never loses any.

## Workspace event

#### Attributes

`eventId` uuid

Event UUID.

`eventType` enum

What happened.

One of: `invoice.paid`, `invoice.payment_failed`, `bill.created`, `bank_feed.synced`

`occurredAt` datetime

When it happened (ISO 8601).

`subjectType` enum

The kind of record `subjectUuid` points at.

One of: `invoice`, `bill`, `connection`

`subjectUuid` uuid

UUID of the invoice, bill, or bank connection.

`documentNumber` string

Invoice or bill number, when the event has one.

`counterparty` object

The customer or vendor, when the event has one.

`type` enum

Counterparty kind.

One of: `customer`, `vendor`

`uuid` uuid

Customer or vendor UUID.

`amount` object

The amount, when the event has one.

`decimalAmount` string

Amount as a decimal string with two places.

`currency` string

ISO currency code.

`approvalStatus` string

Bill approval status on `bill.created`.

`newTransactionCount` integer

Transactions the sync brought in, on `bank_feed.synced`.

Example

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

Scope and permissions

Needs the `workspace:read` scope. The connecting user needs any one of `view_invoices`, `view_bills`, or `view_transactions`, and only the event types they may view are returned. The app's grant narrows it further: invoice events need `invoices:read`, `bill.created` needs `bills:read`, and `bank_feed.synced` needs `transactions:read`.

MCP equivalent

COUNT_list_workspace_events.

## Related

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

## Endpoints

[GET List workspace events `/firm-partners/workspace/workspace-events` Returns the events since the user last checked, or since a given time, oldest first.](https://developers.getcount.com/practice-manager/reference/workspace-events/list-workspace-events)
