Listing Invoices
Fetch and browse your submitted invoices and credit notes.
Retrieve a paginated list of invoices submitted through your account. Each entry includes the invoice number, current delivery status, and creation timestamp.
Pagination
Use limit and offset to paginate through results.
Results are returned newest-first.
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
limit | number | Optional | Number of results to return (default: 20, max: 100) |
offset | number | Optional | Number of results to skip (for pagination) |
For real-time delivery notifications, use
Webhooks instead
of polling this endpoint.
import { Peppol } from "@getpeppr/sdk";
const peppol = new Peppol({ apiKey: "sk_live_..." });
// List invoices with pagination
const { data: invoices, meta } = await peppol.invoices.list({
limit: 10,
offset: 0,
});
for (const invoice of invoices) {
console.log(`Invoice: ${invoice.number}`);
console.log(`Status: ${invoice.status}`);
console.log(`Created: ${invoice.createdAt ?? "n/a"}`);
console.log("---");
}
console.log(`Total: ${meta.totalCount} invoices`);