Reference · Bills
List bills
GET
https://api.paygoro.com/v1/billsLists payable invoices in the bill-pay inbox, newest first. Paginated; filter by company or status.
Authorization
Requires a bearer API key with bills:read. See Authentication.
Query parameters
| Name | Type | Description |
|---|---|---|
companyId | string | Restrict to one legal entity. Omit to include every entity in the workspace. |
status | "new" | "processing" | "extract_failed" | "pending_match" | "matched" | "pending_approval" | "approved" | "scheduled" | "paid" | "rejected" | "archived" | |
updatedAfter | string (date-time) | Only bills created or changed after this instant. |
limit | integer | Page size, 1–100. Defaults to 50. |
cursor | string | Opaque pagination cursor from a previous response's `nextCursor`. |
Response
200 · application/json
| Field | Type | Description |
|---|---|---|
data | array of object | |
nextCursor | string | null | Pass as `cursor` to fetch the next page. `null` when this is the last page. |
id | string | Opaque resource id. |
companyId | string | Opaque resource id. |
status | "new" | "processing" | "extract_failed" | "pending_match" | "matched" | "pending_approval" | "approved" | "scheduled" | "paid" | "rejected" | "archived" | |
supplierName | string | null | |
supplierIban | string | null | |
invoiceNumber | string | null | |
totalAmount | string | null | |
vatAmount | string | null | |
currency | string | null | |
invoiceDate | string (date) | null | |
dueDate | string (date) | null | |
paymentReference | string | null | |
matchedTransactionId | string | null | The transaction that settled this bill, once matched. |
paidAt | string (date-time) | null | |
createdAt | string (date-time) | Timestamp in RFC 3339 format (UTC). |
updatedAt | string (date-time) | Timestamp in RFC 3339 format (UTC). |
Errors
| 400 | BAD_REQUEST | The request was malformed or failed validation. |
| 401 | UNAUTHORIZED | Missing, malformed, expired or revoked API key. |
| 403 | FORBIDDEN | The API key does not have the scope this operation requires. |
| 404 | NOT_FOUND | No resource with this id exists in your workspace, or a `companyId` filter does not match one of your companies. |
| 429 | TOO_MANY_REQUESTS | Rate limit exceeded. Retry after the `Retry-After` header. |
All errors share one envelope — see Errors.