Reference · Bills
Get a bill
GET
https://api.paygoro.com/v1/bills/{id}Authorization
Requires a bearer API key with bills:read. See Authentication.
Path parameters
| Name | Type | Description |
|---|---|---|
idrequired | string | Opaque resource id. |
Response
200 · application/json
| Field | Type | Description |
|---|---|---|
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.