List invoices
curl --request GET \
--url https://api.voucher-staging.allride.io/consumer/v1/billing/invoices \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.voucher-staging.allride.io/consumer/v1/billing/invoices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.voucher-staging.allride.io/consumer/v1/billing/invoices"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)HttpResponse<String> response = Unirest.get("https://api.voucher-staging.allride.io/consumer/v1/billing/invoices")
.header("Authorization", "Bearer <token>")
.asString();package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.voucher-staging.allride.io/consumer/v1/billing/invoices"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.voucher-staging.allride.io/consumer/v1/billing/invoices",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"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
}
}Billing
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 --request GET \
--url https://api.voucher-staging.allride.io/consumer/v1/billing/invoices \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.voucher-staging.allride.io/consumer/v1/billing/invoices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.voucher-staging.allride.io/consumer/v1/billing/invoices"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)HttpResponse<String> response = Unirest.get("https://api.voucher-staging.allride.io/consumer/v1/billing/invoices")
.header("Authorization", "Bearer <token>")
.asString();package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.voucher-staging.allride.io/consumer/v1/billing/invoices"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.voucher-staging.allride.io/consumer/v1/billing/invoices",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"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
Your API key in Authorization: Bearer <key>. Use vk_test_… keys against the sandbox and vk_live_… keys against production.
Query Parameters
Page number, 1-100,000 (default 1). Outside the range: 400 data-failed-validation with the constraint invalid-page.
Required range:
1 <= x <= 100000Items per page, 1-100 (default 25). Outside the range: 400 data-failed-validation with the constraint invalid-page.
Required range:
1 <= x <= 100One 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"
Case-insensitive search (at most 255 characters) over number.
Maximum string length:
255Invoice status (equals).
Available options:
finalised, sent, partially-paid, paid, overdue, void, uncollectible Invoice status (one of (comma-separated)). Comma-separated values.
Issue date (download key) (greater than).
Issue date (download key) (greater than or equal).
Issue date (download key) (less than).
Issue date (download key) (less than or equal).
Due date (greater than or equal).
Due date (less than or equal).
Service month (equals).
Pattern:
^\d{4}-\d{2}$Service month (one of (comma-separated)). Comma-separated values.
Invoice kind (equals).
Available options:
periodic, final, corrective, cancellation Invoice kind (one of (comma-separated)). Comma-separated values.
Collection method (equals).
Available options:
sepa-debit, bank-transfer Response
OK
Page envelope of Invoice items.
The page.
Show child attributes
Show child attributes