List Tax Invoices

​

Returns issued Tax Invoices for the selected recipient account, newest first. Use the results to reconcile invoice numbers, periods, amounts, and PDF availability. Only issued invoices are included.

Requests use your authenticated account and test or live mode. An authorized platform can select a connected recipient account with the Paypercut-Account header. Pagination cursors belong to that account and mode; start a new list when either changes.

Set limit to control the page size. When has_more is true, pass the returned last_key unchanged to request the next page. The final page returns has_more: false and last_key: null.

Store each invoice's id for the download operation. A status of issued does not mean the PDF is ready: check download_available or wait for tax_invoice.available before requesting a download URL.

You can also review invoices in Settings → Invoices. Related guide: Tax Invoices.

Query Parameters

  • limit
    Type: integer
    min:  
    1
    max:  
    100

    Maximum number of Tax Invoices to return. Defaults to 50.

  • last_key
    Type: string
    min length:  
    1
    max length:  
    500

    Opaque cursor returned by a previous page. Omit it for the first page. Pass it unchanged with the same account and test or live mode; do not use an invoice ID as the cursor.

Responses

  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/v1/tax_invoices
curl 'https://api.paypercut.io/v1/tax_invoices?limit=50' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
Final page with a downloadable Tax Invoice
{
  "object": "list",
  "data": [
    {
      "id": "vati_01KAGY7ZM69W83AXEH3NRXP6JD",
      "issue_date": "2026-09-01",
      "object": "tax_invoice",
      "status": "issued",
      "number": "0000000012",
      "amount": 12000,
      "currency": {
        "code": "EUR",
        "scale": 2
      },
      "type": "vat_invoice",
      "title": "Tax Invoice",
      "description": "Tax Invoice for August 2026",
      "period": {
        "start_date": "2026-08-01",
        "end_exclusive": "2026-09-01"
      },
      "account": "01KAKB228G3K4E98NFVE2MGHW4",
      "livemode": false,
      "download_available": true,
      "download_url": "/v1/tax_invoices/vati_01KAGY7ZM69W83AXEH3NRXP6JD/download"
    }
  ],
  "has_more": false,
  "last_key": null,
  "url": "/v1/tax_invoices"
}

A page of issued Tax Invoices for the selected account and mode.