---
title: "Invoices, receivables (AR, default), payables (AP) or both"
method: POST
path: "/api/v1/open_invoices"
---

# Invoices, receivables (AR, default), payables (AP) or both

`POST /api/v1/open_invoices`

## Request

- Base URL: `https://k-phi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://k-phi.com/api/v1/open_invoices`
- Auth: HTTP bearer

Invoices, receivables (AR, default), payables (AP) or both. By default the OPEN ones with their aging per currency (not due, 1-30, 31-60, 61-90, over 90 days) and the counterparties with the most overdue. With status paid or all, or a date range (by issue or due date), it lists every matching invoice with totals per currency (amount and still open). Filter by entity, counterparty or invoice number (the number gives that invoice’s detail). Use for "who owes me money", "what is overdue", "what did customer X pay this year", "invoices issued in March", "show invoice 1042".

## Request body

- object
  - `direction` 'AR' | 'AP' | 'both'
  - `status` 'open' | 'paid' | 'all': Default open
  - `overdue_only` boolean
  - `from` string: YYYY-MM-DD
  - `to` string: YYYY-MM-DD
  - `date_field` 'issue' | 'due': Which date from / to apply to; default issue
  - `entity` string: Entity code
  - `counterparty` string: Customer or supplier name (part of it) or code
  - `number` string: An invoice number: that invoice only
  - `limit` number: 1 to 100, default 25

## Response `200`

OK

- object
  - `data` object
  - `meta` object
    - `api` string
    - `capability` string
    - `at` string

## Other responses

- `401`: No or invalid credential
- `403`: Scope, extension or Builder Mode refused
- `422`: The capability refused the input
- `429`: Rate or daily quota reached

---

[API](https://skmtc.dev/k-phi/apis/k-api.md) · [All operations](https://skmtc.dev/k-phi/apis/k-api/llms.txt) · [OpenAPI document](https://skmtc.dev/k-phi/apis/k-api/revisions/60b28690ec35?raw)