---
title: "Customer cash-by-entity card (accountant mirror)"
method: GET
path: "/accountant/companies/{customerId}/metrics/cash-by-entity"
tags: ["Overview"]
---

# Customer cash-by-entity card (accountant mirror)

`GET /accountant/companies/{customerId}/metrics/cash-by-entity`

## Request

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

Accountant-scoped mirror of `GET /companies/{companyId}/metrics/cash-by-entity`. Inherently cross-entity (no `entityId` param): rows cover the customer's full non-group entity roster — the accountant's company-wide read authority stands in for the per-user entity grants the customer mount filters by. Same honesty gates as the customer mount: `available:false` with reason `single_entity` for single-entity customers and `no_cash_accounts` when no cash accounts exist.

## Response `200`

Cash-by-entity envelope (same shape as the customer mount)

- CashByEntityResponse
  - `success` true, required
  - `data` CashByEntityData, required
    - `available` boolean, required
    - `reason` 'single_entity' | 'no_accessible_entities' | 'no_cash_accounts': Present only when available is false. single_entity: the company has at most one non-group legal entity (the card is only meaningful across entities). no_accessible_entities: the actor's entity grants cover none of the entities. no_cash_accounts: the company has no cash GL accounts.
    - `entities` CashByEntityRow[], required: One row per authorized non-group legal entity; empty when available is false.
      - `entityId` string, uuid, required
      - `name` string, required
      - `balanceCents` integer, required: Cumulative posted cash balance for the entity, in cents, expressed in the entity's functional currency (never the company presentation currency).
      - `currency` string, required: The entity's functional currency (ISO 4217). The card formats each row with its own currency so foreign-functional entities are not mislabeled with the presentation symbol.
    - `asOf` string, date, required: YYYY-MM-DD the balances are posted through (today).

## Other responses

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

---

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