# List invoices

`GET /lokta-lms/api/v1/invoices`

Lists partner invoices, with filters for partner, status, period and overdue.

Filters: `partner_id`, `status` (repeatable), `period_start`, `period_end`, `overdue=true`.

`is_overdue` is derived from `due_on` against today, never stored; nothing writes to an invoice on the day it becomes late, so a stored flag would be wrong from the moment the clock passed it. A `paid` or `cancelled` invoice is never overdue however old it is.

Statuses: `draft · awaiting_approval · approved · paid · cancelled`.

Lines are returned on the element read, not the list.

## Parameters
- `partner_id` (query, string)
- `status` (query, array)
- `period_start` (query, string)
- `period_end` (query, string)
- `overdue` (query, boolean)
- `limit` (query, integer)
- `cursor` (query, string)

## Responses
- `default`: default response

## Example request (cURL)
```bash
curl -X GET \
  'https://default.lokta.tech/lokta-lms/api/v1/invoices' \
  -u '{username}:{password}' \
  -H 'Tenant-Identifier: default'
```

Interactive: https://developer.lokta.ai/reference#operation/list_2