List invoices

GET https://api.invunion.com/api/v1/invoices invoices:read Markdown

List invoices for the authenticated tenant.

Returns a paginated list of invoices and credit notes. Filters combine with AND. Each item includes counterparty display fields and computed overdue flags. Payment-schedule installments are not included on the list; use Get invoice.

Query parameters

Name	Type	Required
`pageSize` Page size. Default 20, maximum 100. Example: 20	integer	Optional
`cursor` Opaque cursor: pass the nextCursor of the previous response. Valid only with the same sortBy, sortOrder, and filters. Omit it for the first page. Example: Y3JlYXRlZF9hdDpkZXNjfDIwMjYtMDktMDhUMTQ6MTA6MDAuMDAwWnw3ZDljMTNlNA	string Max 512	Optional
`includeTotal` total is returned on the first page unless includeTotal=false, and on cursor pages only when includeTotal=true. Skip it to save a count. Allowed values`truefalse`	boolean	Optional
`page` Deprecated. Offset page number kept for older integrations; use cursor instead. Ignored when cursor is sent. Example: 2	integer	Optional
`updatedSince` ISO 8601 instant. Returns only rows modified strictly after it. Use it with cursor for incremental sync. Example: 2026-09-01T00:00:00Z	string No maximum	Optional
`sortBy` Sort column. Default invoice_date.	string No maximum	Optional
Allowed values`invoice_numberinvoice_datedue_dateamount_incl_vatrecovery_percentsettled_amountopen_amountvat_amountstatuscreated_at`
`sortOrder` Sort direction. Default desc. Allowed values`ascdesc`	string No maximum	Optional
`status` Single status or comma-separated list. overdue is computed from open amount past due, not only stored status. unmatched means unpaid or overdue.	string No maximum	Optional
Allowed values`unpaidpartialpaidcancelledoverdueunmatched`
`type` issued (you billed) or received (you were billed). Allowed values`issuedreceived`	string No maximum	Optional
`kind` Invoice or credit note. Allowed values`invoicecredit_note`	string No maximum	Optional
`counterpartyId` Filter by counterparty code (`account_code`). Example: CPT-042	string No maximum	Optional
`paymentMethod` Expected payment channel.	string No maximum	Optional
Allowed values`cardtransferdirect_debitcashcheckcryptoother`
`search` Case-insensitive match on invoice_number, recipient_name, customer_name, external_reference, or description. Example: INV-2026	string Max 100	Optional
`externalReference` Exact external reference. Example: LC-SO-9081	string Max 255	Optional
`startDate` Inclusive start of invoice_date (YYYY-MM-DD). Example: 2026-09-01	string No maximum	Optional
`endDate` Inclusive end of invoice_date (YYYY-MM-DD). Example: 2026-09-30	string No maximum	Optional
`dueStartDate` Inclusive start of due_date (YYYY-MM-DD). Example: 2026-09-01	string No maximum	Optional
`dueEndDate` Inclusive end of due_date (YYYY-MM-DD). Example: 2026-10-31	string No maximum	Optional
`minRecovery` Minimum recovery_percent (0-100). Example: 0	number	Optional
`maxRecovery` Maximum recovery_percent (0-100). Example: 100	number	Optional
`hasOpen` If true, only invoices with open_amount > 0. Allowed values`truefalse`	boolean	Optional
`overdue` If true, only invoices past their next due date with an open amount. Allowed values`truefalse`	boolean	Optional

Errors

This operation can return the following errors in addition to generic HTTP failures.

Error	HTTP code	Description
`Missing Bearer token`	401	The Authorization header is missing or is not a Bearer token.
`Invalid or revoked API key`	401	The API key is unknown, malformed, expired, or has been revoked.
`API key is missing scope invoices:read`	403	The key does not include invoices:read. A write scope does not imply the matching read scope.
`Too many requests, please try again later`	429	More than 100 requests in one minute from this API key or IP address. Wait for the Retry-After header (seconds) and retry.
`Invalid query parameters`	400	A query value failed validation. details lists field and message.
`Internal server error`	500	Unexpected server error. The JSON body includes correlationId. Retry with backoff.

Previous: Ingest transactions (deprecated) Next: Get invoice

Request

Requests in the examples call https://api.invunion.com/api/v1/invoices.

curl --request GET \
  --url https://api.invunion.com/api/v1/invoices?pageSize=20&type=issued \
  --header 'accept: application/json' \
  --header 'authorization: Bearer uk_live_YOUR_API_KEY'

import requests

url = "https://api.invunion.com/api/v1/invoices?pageSize=20&type=issued"
headers = {
    "Accept": "application/json",
    "Authorization": "Bearer uk_live_YOUR_API_KEY",
}
response = requests.get(url, headers=headers)
print(response.json())

require 'net/http'
require 'json'
require 'uri'

uri = URI("https://api.invunion.com/api/v1/invoices?pageSize=20&type=issued")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Accept'] = 'application/json'
request['Authorization'] = 'Bearer uk_live_YOUR_API_KEY'
response = http.request(request)
puts response.body

const response = await fetch("https://api.invunion.com/api/v1/invoices?pageSize=20&type=issued", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": "Bearer uk_live_YOUR_API_KEY"
  },
});
const data = await response.json();

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.invunion.com/api/v1/invoices?pageSize=20&type=issued", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer uk_live_YOUR_API_KEY")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

const response = await fetch("https://api.invunion.com/api/v1/invoices?pageSize=20&type=issued", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": "Bearer uk_live_YOUR_API_KEY"
  },
});
console.log(await response.json());

200

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
        "tenant_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "counterparty_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "invoice_number": "INV-2026-0042",
        "kind": "invoice",
        "invoice_type": "issued",
        "status": "partial",
        "currency": "EUR",
        "amount_excl_vat": 10000,
        "vat_amount": 2000,
        "amount_incl_vat": 12000,
        "settled_amount": 1000,
        "open_amount": 11000,
        "recovery_percent": 8.33,
        "invoice_date": "2026-09-01T00:00:00.000Z",
        "due_date": "2026-10-01T00:00:00.000Z",
        "payment_expected_date": "2026-10-01T00:00:00.000Z",
        "payment_term_days": null,
        "recipient_name": "Leones Cars",
        "customer_name": "Leones Cars",
        "description": "Fleet maintenance — September 2026",
        "external_reference": "LC-SO-9081",
        "counterparty_name_display": "Leones Cars",
        "is_overdue": false,
        "next_due_date": "2026-10-01",
        "created_at": "2026-09-01T10:00:00.000Z",
        "updated_at": "2026-09-12T09:00:00.000Z"
      },
      {
        "id": "8ead24f5-4b17-4092-db14-21508c3ea6d4",
        "tenant_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "counterparty_id": "4b7a91c2-18e4-4d6f-a8c1-9e2d5f0b73a1",
        "invoice_number": "INV-2026-0043",
        "kind": "invoice",
        "invoice_type": "received",
        "status": "paid",
        "currency": "USD",
        "amount_excl_vat": 3500,
        "vat_amount": 700,
        "amount_incl_vat": 4200,
        "settled_amount": 4200,
        "open_amount": 0,
        "recovery_percent": 100,
        "invoice_date": "2026-08-25T00:00:00.000Z",
        "due_date": "2026-09-09T00:00:00.000Z",
        "payment_expected_date": "2026-09-09T00:00:00.000Z",
        "payment_term_days": null,
        "recipient_name": "Invunion Demo",
        "customer_name": "Grove Street Garage",
        "description": "Spare parts — August 2026",
        "external_reference": "PO-1904",
        "counterparty_name_display": "Grove Street Garage",
        "is_overdue": false,
        "next_due_date": "2026-09-09",
        "created_at": "2026-08-25T11:20:00.000Z",
        "updated_at": "2026-09-09T00:00:00.000Z"
      }
    ],
    "total": 2,
    "page": 1,
    "pageSize": 20,
    "hasMore": false,
    "nextCursor": null
  }
}