Skip to main content
GET
Search CoworkerInvoiceHistories
A CoworkerInvoiceHistory records a history entry for a customer invoice. Each entry captures an activity or event that occurred on that invoice, such as the invoice being sent, an e-invoicing action, a payment receipt, or a payment error. Use IsProblem to flag entries that represent errors or issues (e.g. a failed payment attempt). Set Notify to trigger a notification when the history entry is created.

Authentication

This endpoint requires OAuth2 authentication. Include a valid bearer token in the Authorization header. The authenticated user must be a full unrestricted administrator or have the CoworkerInvoiceHistory-List role.

Query Parameters

Pagination & Sorting

integer
default:"1"
The page number to retrieve.
integer
default:"25"
The number of records per page.
string
The property name to sort results by (e.g. Name, CreatedOn).
integer
Sort direction. 0 for ascending, 1 for descending.

Filters

integer
Filter by iD of the coworker invoice linked to this record.
integer
Filter by iD of the coworker invoice coworker associated with this record.
integer
Filter by iD of the coworker invoice business associated with this record.
string
Filter by the coworker invoice business currency code value for this coworker invoice history.
string
Filter by full name of the customer who owns the invoice.
string
Filter by total amount of the related customer invoice.
string
Filter by invoice number of the related customer invoice.
string
Filter by display name of the linked coworker invoice bill to (read-only).
string
Filter by whether the related customer invoice has been fully paid.
string
Filter by date/time value for coworker invoice paid on.
boolean
Filter by whether coworker invoice refunded is enabled.
string
Filter by date/time value for coworker invoice refunded on.
string
Filter by date/time value for coworker invoice due date.
string
Filter by whether the related customer invoice is still in draft.
string
Filter by short title of the history entry (e.g. ‘Invoice sent’, ‘Payment received’).
string
Filter by detailed description of the activity or event recorded by this history entry.
boolean
Filter by flags this history entry as an error or issue (e.g. a failed payment attempt or e-invoicing error).
boolean
Filter by whether to send a notification when this history entry is created.

Range Filters

integer
Filter by iD of the coworker invoice coworker associated with this record greater than or equal to this value.
integer
Filter by iD of the coworker invoice coworker associated with this record less than or equal to this value.
integer
Filter by iD of the coworker invoice business associated with this record greater than or equal to this value.
integer
Filter by iD of the coworker invoice business associated with this record less than or equal to this value.
string
Filter by date/time value for coworker invoice paid on greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter by date/time value for coworker invoice paid on less than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter by date/time value for coworker invoice refunded on greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter by date/time value for coworker invoice refunded on less than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter by date/time value for coworker invoice due date greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter by date/time value for coworker invoice due date less than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter records created on or after this date. Format: YYYY-MM-DDTHH:mm.
string
Filter records created on or before this date. Format: YYYY-MM-DDTHH:mm.
string
Filter records updated on or after this date. Format: YYYY-MM-DDTHH:mm.
string
Filter records updated on or before this date. Format: YYYY-MM-DDTHH:mm.

Code Examples

Simple listing

Filtering by Name

Range filters

Response

200

CoworkerInvoiceHistory[]
The list of CoworkerInvoiceHistory records matching the query. See the Get one CoworkerInvoiceHistory endpoint for the full list of properties returned for each record.
integer
Current page number.
integer
Number of records per page.
string
The field used for sorting.
integer
The sort direction (0 = ascending, 1 = descending).
integer
Index of the first item on the current page.
integer
Index of the last item on the current page.
integer
Total number of matching records across all pages.
integer
Total number of pages.
boolean
Whether there is a next page of results.
boolean
Whether there is a previous page of results.
Example Response