List invoices

Lists your finalised invoices. Stornorechnungen are listed too (kind: cancellation, negative amounts). To fetch new invoices into your ERP, subscribe to invoice-finalised, or poll daily with filter[issueDate][gte]=<last run>&sort=issueDate. Drafts are never visible. See the billing guide.

Required permissions: view-consumer-billing · API keys: allowed

GET /consumer/v1/billing/invoices

List invoices

cURL

curl --request GET \
  --url https://api.voucher-staging.allride.io/consumer/v1/billing/invoices \
  --header 'Authorization: Bearer <token>'

200

default

{
  "data": {
    "data": [
      {
        "id": 19044,
        "resource": "invoice",
        "number": "VP-R-2026-000051",
        "kind": "cancellation",
        "status": "sent",
        "serviceMonth": "2026-10",
        "servicePeriodStart": "2026-10-01",
        "servicePeriodEnd": "2026-10-31",
        "cancelsInvoiceId": 19017,
        "cancelledByInvoiceId": null,
        "issueDate": "2026-11-09",
        "dueDate": "2026-11-09",
        "collectionMethod": null,
        "collectionDate": null,
        "netAmount": {
          "value": -128000,
          "label": "-€1,280.00"
        },
        "taxAmount": {
          "value": -24320,
          "label": "-€243.20"
        },
        "grossAmount": {
          "value": -152320,
          "label": "-€1,523.20"
        },
        "amountPaid": {
          "value": 0,
          "label": "€0.00"
        },
        "amountCancelled": {
          "value": 0,
          "label": "€0.00"
        },
        "amountDue": {
          "value": 0,
          "label": "€0.00"
        },
        "taxTreatment": "domestic",
        "taxBreakdown": [
          {
            "category": "standard",
            "rate": "19.00",
            "netAmount": {
              "value": -128000,
              "label": "-€1,280.00"
            },
            "taxAmount": {
              "value": -24320,
              "label": "-€243.20"
            }
          }
        ],
        "paymentInstructions": {
          "type": "settled"
        },
        "lineCount": 6,
        "eInvoiceFormat": "zugferd-en16931",
        "language": "de",
        "dunningLevel": "none",
        "sentAt": "2026-11-09T07:05:12Z",
        "paidAt": null,
        "_links": {
          "self": {
            "href": "https://api.voucher.allride.io/consumer/v1/billing/invoices/19044",
            "type": "application/json"
          },
          "lines": {
            "href": "https://api.voucher.allride.io/consumer/v1/billing/invoices/19044/lines",
            "type": "application/json"
          },
          "document": {
            "href": "https://api.voucher.allride.io/consumer/v1/billing/invoices/19044/document?format=pdf",
            "type": "application/json"
          }
        }
      },
      {
        "id": 19017,
        "resource": "invoice",
        "number": "VP-R-2026-000042",
        "kind": "periodic",
        "status": "void",
        "serviceMonth": "2026-10",
        "servicePeriodStart": "2026-10-01",
        "servicePeriodEnd": "2026-10-31",
        "cancelsInvoiceId": null,
        "cancelledByInvoiceId": 19044,
        "issueDate": "2026-11-02",
        "dueDate": "2026-11-16",
        "collectionMethod": "sepa-debit",
        "collectionDate": "2026-11-16",
        "netAmount": {
          "value": 128000,
          "label": "€1,280.00"
        },
        "taxAmount": {
          "value": 24320,
          "label": "€243.20"
        },
        "grossAmount": {
          "value": 152320,
          "label": "€1,523.20"
        },
        "amountPaid": {
          "value": 0,
          "label": "€0.00"
        },
        "amountCancelled": {
          "value": 152320,
          "label": "€1,523.20"
        },
        "amountDue": {
          "value": 0,
          "label": "€0.00"
        },
        "taxTreatment": "domestic",
        "taxBreakdown": [
          {
            "category": "standard",
            "rate": "19.00",
            "netAmount": {
              "value": 128000,
              "label": "€1,280.00"
            },
            "taxAmount": {
              "value": 24320,
              "label": "€243.20"
            }
          }
        ],
        "paymentInstructions": {
          "type": "sepa-debit",
          "mandateReference": "EXAMPLE-MANDATE-REF",
          "creditorId": "DE00ZZZ00000000000",
          "ibanLast4": "3000",
          "collectionDate": "2026-11-16"
        },
        "lineCount": 6,
        "eInvoiceFormat": "zugferd-en16931",
        "language": "de",
        "dunningLevel": "none",
        "sentAt": "2026-11-02T07:05:12Z",
        "paidAt": null,
        "_links": {
          "self": {
            "href": "https://api.voucher.allride.io/consumer/v1/billing/invoices/19017",
            "type": "application/json"
          },
          "lines": {
            "href": "https://api.voucher.allride.io/consumer/v1/billing/invoices/19017/lines",
            "type": "application/json"
          },
          "document": {
            "href": "https://api.voucher.allride.io/consumer/v1/billing/invoices/19017/document?format=pdf",
            "type": "application/json"
          }
        }
      }
    ],
    "page": 1,
    "perPage": 25,
    "totalPages": 1,
    "total": 2
  }
}

Authorizations

Authorization · string · header · required

Your API key in Authorization: Bearer <key>. Use vk_test_… keys against the sandbox and vk_live_… keys against production.

Query Parameters

page · integer · default: 1

Page number, 1-100,000 (default 1). Outside the range: 400 data-failed-validation with the constraint invalid-page.

Required range: 1 <= x <= 100000

perPage · integer · default: 25

Items per page, 1-100 (default 25). Outside the range: 400 data-failed-validation with the constraint invalid-page.

Required range: 1 <= x <= 100

sort · string

One sort field; prefix - for descending (sort=field or sort=-field). Allowed: issueDate, dueDate, number, grossAmount, amountDue. Default -issueDate. The server appends id as a tie-breaker.

Example:

"-issueDate"

search · string

Case-insensitive search (at most 255 characters) over number.

Maximum string length: 255

filter[status] · enum<string>

Invoice status (equals).

Available options: finalised, sent, partially-paid, paid, overdue, void, uncollectible

filter[status][in] · string

Invoice status (one of (comma-separated)). Comma-separated values.

filter[issueDate][gt] · string<date>

Issue date (download key) (greater than).

filter[issueDate][gte] · string<date>

Issue date (download key) (greater than or equal).

filter[issueDate][lt] · string<date>

Issue date (download key) (less than).

filter[issueDate][lte] · string<date>

Issue date (download key) (less than or equal).

filter[dueDate][gte] · string<date>

Due date (greater than or equal).

filter[dueDate][lte] · string<date>

Due date (less than or equal).

filter[serviceMonth] · string

Service month (equals).

Pattern: ^\d{4}-\d{2}$

filter[serviceMonth][in] · string

Service month (one of (comma-separated)). Comma-separated values.

filter[kind] · enum<string>

Invoice kind (equals).

Available options: periodic, final, corrective, cancellation

filter[kind][in] · string

Invoice kind (one of (comma-separated)). Comma-separated values.

filter[collectionMethod] · enum<string>

Collection method (equals).

Available options: sepa-debit, bank-transfer

Response

200

application/json

OK

Page envelope of Invoice items.

data · object · required

The page.

Show child attributes