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

# Customer revenue-mix card (accountant mirror)

`GET /accountant/companies/{customerId}/metrics/revenue-mix`

## Request

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

Accountant-scoped mirror of `GET /companies/{companyId}/metrics/revenue-mix` — the same service, so the accountant sees the numbers the customer's Home revenue-mix card shows. 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

## Response `200`

Revenue-mix payload (same shape as the customer mount)

- RevenueMixResponse
  - `success` true, required
  - `data` RevenueMixData, required
    - `available` boolean, required: False when the window holds no posted revenue lines (months empty).
    - `reason` 'mixed_currencies': Present only when available is false because the company-wide read spans entities in different functional currencies (banned before consolidation). Entity-scoped reads are single-currency and never carry this.
    - `basis` 'billing-source', required
    - `months` RevenueMixMonth[], required: Ascending; the 6 complete months plus the current month-to-date, every month present (zero-filled) when available.
      - `month` string, required
      - `recurringCents` integer, required: Posted revenue with recurring billing provenance, in cents.
      - `servicesCents` integer, required: Posted revenue with services billing provenance, in cents.
      - `otherCents` integer, required: Posted revenue with no recognizable billing provenance, in cents.

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