CoworkerInvoiceHistories
Search CoworkerInvoiceHistories
Search and list CoworkerInvoiceHistory records with filtering, sorting, and pagination.
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 display value for CoworkerInvoice.Coworker.Id..
integer
Filter by display value for CoworkerInvoice.Business.Id..
string
Filter by display value for CoworkerInvoice.Business.Currency.Code..
string
Filter by display value for CoworkerInvoice.Coworker.FullName..
number
Filter by display value for CoworkerInvoice.TotalAmount..
string
Filter by display value for CoworkerInvoice.InvoiceNumber..
string
Filter by display value for CoworkerInvoice.BillToName..
boolean
Filter by display value for CoworkerInvoice.Paid..
string
Filter by display value for CoworkerInvoice.PaidOn..
boolean
Filter by display value for CoworkerInvoice.Refunded..
string
Filter by display value for CoworkerInvoice.RefundedOn..
string
Filter by display value for CoworkerInvoice.DueDate..
boolean
Filter by display value for CoworkerInvoice.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 display value for CoworkerInvoice.Coworker.Id. greater than or equal to this value.
integer
Filter by display value for CoworkerInvoice.Coworker.Id. less than or equal to this value.
integer
Filter by display value for CoworkerInvoice.Business.Id. greater than or equal to this value.
integer
Filter by display value for CoworkerInvoice.Business.Id. less than or equal to this value.
number
Filter by display value for CoworkerInvoice.TotalAmount. greater than or equal to this value.
number
Filter by display value for CoworkerInvoice.TotalAmount. less than or equal to this value.
string
Filter by display value for CoworkerInvoice.PaidOn. greater than or equal to this value. Format:
YYYY-MM-DDTHH:mm.string
Filter by display value for CoworkerInvoice.PaidOn. less than or equal to this value. Format:
YYYY-MM-DDTHH:mm.string
Filter by display value for CoworkerInvoice.RefundedOn. greater than or equal to this value. Format:
YYYY-MM-DDTHH:mm.string
Filter by display value for CoworkerInvoice.RefundedOn. less than or equal to this value. Format:
YYYY-MM-DDTHH:mm.string
Filter by display value for CoworkerInvoice.DueDate. greater than or equal to this value. Format:
YYYY-MM-DDTHH:mm.string
Filter by display value for CoworkerInvoice.DueDate. 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