---
title: "Customer recent bookkeeping activity (accountant mirror)"
method: GET
path: "/accountant/companies/{customerId}/overview/activity-summary"
tags: ["Overview"]
---

# Customer recent bookkeeping activity (accountant mirror)

`GET /accountant/companies/{customerId}/overview/activity-summary`

## Request

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

Accountant-scoped mirror of `GET /companies/{companyId}/overview/activity-summary`. Same counts for the same window (`days` clamped 1-90, default 7). Entity scope is resolved from the customer's own entity roster (accountants hold no per-user entity grants): an explicit `entityId` must be one of the customer's concrete (non-group) entities; absent, the customer's single concrete entity is used; a multi-entity customer without `entityId` gets 422 ENTITY_SELECTION_REQUIRED and a customer with no entity gets 422 ENTITY_SCOPE_UNAVAILABLE.

## Query parameters

- `entityId` string, uuid
- `days` integer

## Response `200`

Entity-scoped activity payload (same shape as the customer mount)

- OverviewActivitySummaryResponse
  - `success` true, required
  - `data` OverviewActivitySummaryData, required
    - `windowDays` integer, required
    - `startDate` string, date, required
    - `endDate` string, date, required
    - `transactionsCategorized` integer, required
    - `documentsMatched` integer, required
    - `businessEventsRecorded` integer, required
    - `reconciliationsCompleted` integer, required
    - `booksStatus` object, nullable, required: Books status is company-wide, not legal-entity-dimensional. Served for an unscoped activity request and for the company's sole non-group legal entity (it owns every company activity); null for one legal entity of a real multi-entity company, or when the entity roster cannot be verified (see booksStatusAvailability). Never fabricated.
    - `booksStatusAvailability` HomeBooksStatusAvailability, required
      - `available` boolean, required: True for an unscoped request or the company's sole non-group legal entity, to which the company-wide books status is honestly attributable. False for one legal entity of a real multi-entity company, or when the entity roster cannot be verified (no roster, read failure, or an entity not on it): fail closed, never widened.
      - `reason` 'entity_scope_unavailable' | 'null', nullable, required: entity_scope_unavailable whenever available is false; null when available is true.

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member
- `404`: Unknown customer or an explicit entityId not belonging to the customer
- `422`: Request failed validation

---

[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)