---
title: "List business events for an assigned customer"
method: GET
path: "/accountant/companies/{customerId}/business-events"
tags: ["Business Events"]
---

# List business events for an assigned customer

`GET /accountant/companies/{customerId}/business-events`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/accountant/companies/{customerId}/business-events`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Historical events remain listed for accountant review. journalEntryState and journalEntryStateCounts distinguish posted, void, deleted, missing, mixed and not-posted states. generatedJEs includes only live journal entries.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Business events, newest first

- object
  - `success` boolean
  - `data` BusinessEventWire[]
    - `idempotentReplay` boolean: True when a completed create operation was returned without creating or posting again. Posting failures/skips retain their own fields.
    - `id` string, uuid
    - `customerId` string, uuid: The company id (wire name kept for accountant-app compatibility).
    - `eventType` string
    - `status` string
    - `parameters` object
    - `journalEntryId` string, uuid, nullable
    - `generatedEntries` object[]
      - `account` string
      - `accountNumber` string, nullable
      - `debit` number
      - `credit` number
      - `memo` string
    - `generatedJEs` object[]
    - `journalEntryState` 'posted' | 'not_posted' | 'void' | 'deleted' | 'missing' | 'mixed': Consolidated state of every journal entry owned by this event.
    - `journalEntryStateCounts` object
      - `posted` integer, required
      - `void` integer, required
      - `deleted` integer, required
      - `missing` integer, required
    - `jeGenerationSkipped` string: Why journal-entry generation was skipped (named blocker, unresolved accounts, or metadata-only event).
    - `jeGenerationError` string: Unexpected posting failure recorded by the residual safety net (also captured to Sentry).
    - `payablesApItemId` string, uuid: #2529: the Payables (AP) item a posted vendor bill created or linked; its initial journal entry is this event's journal entry.
    - `unresolvedAccounts` string[]
    - `createdAt` string, date-time
    - `createdBy` string, nullable
  - `meta` BusinessEventListMeta: Cursor pagination envelope meta on business-event lists.
    - `nextCursor` string, nullable, required: Pass as `cursor` to fetch the next page; null on the last page.
    - `hasMore` boolean, required

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member

---

[API](https://skmtc.dev/medianfi/apis/median-api.md) · [All operations](https://skmtc.dev/medianfi/apis/median-api/llms.txt) · [OpenAPI document](https://skmtc.dev/medianfi/apis/median-api/revisions/20090ea32b0d?raw)