Skip to main content
GET
Search CoworkerLedgerEntries
A CoworkerLedgerEntry, shown as a ledger entry, records a payment, charge, credit, or adjustment in a customer’s financial ledger for a location and can be applied to an invoice.

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 CoworkerLedgerEntry-List role.

Enums

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 location that owns this ledger entry..
string
Filter by display value for Business.Name..
string
Filter by display value for Business.Currency.Code..
integer
Filter by iD of the customer whose ledger contains this entry..
string
Filter by display value for Coworker.FullName..
integer
Filter by optional ID of the invoice this payment, charge, or credit is applied to..
string
Filter by display value for CoworkerInvoice.InvoiceNumber..
number
Filter by display value for CoworkerInvoice.TotalAmount..
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..
boolean
Filter by display value for CoworkerInvoice.WaitingForInvoiceNumber..
string
Filter by required free-text explanation of the payment, charge, credit, or adjustment..
string
Filter by required ledger reference code; payment and invoice workflows commonly generate codes such as PAYM-, CASH-, CRED-, REFD-, or INVC-..
number
Filter by debit amount in the location currency, rounded to two decimal places when saved; positive debits are invoice charges and negative debits are credit notes. Debit and Credit are mutually exclusive, so set the other amount to zero..
number
Filter by credit amount in the location currency, rounded to two decimal places when saved; positive credits are received payments and negative credits are refunded payments. Credit and Debit are mutually exclusive, so set the other amount to zero..
integer
Filter by payment provider or payment method for this transaction; choosing a connected gateway such as Stripe or Spreedly attempts to collect payment and creation can fail if collection fails. Manual payments cannot use GoCardless, GoCardlessPro, StripeDirectDebit, Xero, Forte, or StripeACH..
string
Filter by payment-method detail supplied by the payment processor; hidden because it can contain sensitive payment information..
string
Filter by date and time of the transaction in UTC; defaults to the current UTC time when omitted and cannot be before the location billing lock date..
number
Filter by read-only running ledger balance calculated by the database as cumulative credits minus debits, ordered by transaction date and entry ID..
boolean
Filter by internal flag tracking whether Nexudus has billed this transaction to the operator; hidden because it is managed by billing workflows..
string
Filter by internal localized copy of TransactionDate derived using the owning location’s time zone; hidden because TransactionDate is the supported input..
string
Filter by internal identifier linking related ledger transactions so that deletion can reverse the connected payment; hidden because it is managed by payment workflows..

Range Filters

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.
number
Filter by debit amount in the location currency, rounded to two decimal places when saved; positive debits are invoice charges and negative debits are credit notes. Debit and Credit are mutually exclusive, so set the other amount to zero. greater than or equal to this value.
number
Filter by debit amount in the location currency, rounded to two decimal places when saved; positive debits are invoice charges and negative debits are credit notes. Debit and Credit are mutually exclusive, so set the other amount to zero. less than or equal to this value.
number
Filter by credit amount in the location currency, rounded to two decimal places when saved; positive credits are received payments and negative credits are refunded payments. Credit and Debit are mutually exclusive, so set the other amount to zero. greater than or equal to this value.
number
Filter by credit amount in the location currency, rounded to two decimal places when saved; positive credits are received payments and negative credits are refunded payments. Credit and Debit are mutually exclusive, so set the other amount to zero. less than or equal to this value.
string
Filter by date and time of the transaction in UTC; defaults to the current UTC time when omitted and cannot be before the location billing lock date. greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter by date and time of the transaction in UTC; defaults to the current UTC time when omitted and cannot be before the location billing lock date. less than or equal to this value. Format: YYYY-MM-DDTHH:mm.
number
Filter by read-only running ledger balance calculated by the database as cumulative credits minus debits, ordered by transaction date and entry ID. greater than or equal to this value.
number
Filter by read-only running ledger balance calculated by the database as cumulative credits minus debits, ordered by transaction date and entry ID. less than or equal to this value.
string
Filter by internal localized copy of TransactionDate derived using the owning location’s time zone; hidden because TransactionDate is the supported input. greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter by internal localized copy of TransactionDate derived using the owning location’s time zone; hidden because TransactionDate is the supported input. 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 Description

Range filters

Response

200

CoworkerLedgerEntry[]
The list of CoworkerLedgerEntry records matching the query. See the Get one CoworkerLedgerEntry endpoint for the full list of properties returned for each record.
Partial records — The listing endpoint returns a summary representation of each CoworkerLedgerEntry. The following fields are not populated in the Records[] response: PaymentMethodNumber.To get all fields, fetch the full record using the Get one CoworkerLedgerEntry endpoint.Important for updates: When updating a record via PUT, always retrieve the full record with a GET request first, apply your changes to that complete data, and then send the updated record. Do not use data from a listing response as the base for a PUT request, as missing fields may be unintentionally cleared.
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