---
title: "Customer's customer records (accountant mirror, read-only)"
method: GET
path: "/accountant/companies/{customerId}/customers"
tags: ["AR/AP"]
---

# Customer's customer records (accountant mirror, read-only)

`GET /accountant/companies/{customerId}/customers`

## Request

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

Accountant-scoped read-only mirror of `GET /companies/{companyId}/customers` (the customer count / top-customers rollup on the customer Home derives from these rows). Same conversion gate (404 while dark). Optional `includeInactive` as on the customer mount. 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

- `includeInactive` boolean

## Response `200`

Same payload as the customer mount: customer records

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member
- `404`: AR/AP items not enabled for this 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)