---
title: "Customer AP bill list (accountant mirror, read-only)"
method: GET
path: "/accountant/companies/{customerId}/ap"
tags: ["AR/AP"]
---

# Customer AP bill list (accountant mirror, read-only)

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

## Request

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

Accountant-scoped read-only mirror of `GET /companies/{companyId}/ap` (bill read models; the open-bills totals the customer app derives are computed from the same rows). Same conversion gate (404 while dark). Optional `status` and `vendorId` filters 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

- `status` string
- `vendorId` string, uuid

## Response `200`

Same payload as the customer mount: ApItem read models

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