/bff/invoice/list

Returns a paginated list of invoices for the organisation. Invoices are sorted by issue date (newest first). Supports filtering by status, type, payment state, customer, date range, and full-text search.

InvoicegetBffInvoiceList

Parameters

9 query

9 total

Query · 9

pagestring

Page number (1-based) for pagination.

limitstring

Maximum items per page (1–500, default 50).

Invoice status.

Document type.

isPaidstring

Filter by payment status: "true" or "false".

customerIdstring

External customer ID for filtering.

dateFromstring

Issue date from (ISO format: YYYY-MM-DD).

dateTostring

Issue date to (ISO format: YYYY-MM-DD).

searchstring

Full-text search in invoice number, email, and customer name.

Request

GET /bff/invoice/list

get

curl -X GET "https://api.bizkithub.com/bff/invoice/list?page=1&limit=50&isPaid=true&customerId=xK9mP2wLn4YzaB3Q&dateFrom=2026-01-01&dateTo=2026-03-31&search=2024001" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

Paginated list of invoices.

{
  "items": [
    {
      "id": "example_id",
      "sequence_number": "example_sequence_number",
      "order_hash": "example_order_hash",
      "order_number": "example_order_number",
      "type": "example_type",
      "status": "example_status",
      "total": "example_total",
      "currency": "example_currency",
      "issuer_id": "example_issuer_id",
      "issuer_name": "example_issuer_name",
      "customer_id": "example_customer_id",
      "customer_name": "example_customer_name",
      "recipient_id": "example_recipient_id",
      "recipient_name": "example_recipient_name"
    }
  ],
  "itemCount": 0
}

All response codes

1 status code documented

Need an API key?

All BizKitHub API endpoints require authentication via API key.

Get API Key