Search CoworkerInvoices

Search and list CoworkerInvoice records with filtering, sorting, and pagination.

GET /api/billing/coworkerinvoices

Search CoworkerInvoices

cURL

curl --request GET \
  --url https://spaces.nexudus.com/api/billing/coworkerinvoices \
  --header 'Authorization: Basic <encoded-value>'

200

{
  "Records": [
    {}
  ],
  "CurrentPage": 123,
  "CurrentPageSize": 123,
  "CurrentOrderField": "<string>",
  "CurrentSortDirection": 123,
  "FirstItem": 123,
  "LastItem": 123,
  "TotalItems": 123,
  "TotalPages": 123,
  "HasNextPage": true,
  "HasPreviousPage": true
}

A CoworkerInvoice represents an invoice document issued to a customer. Invoices track amounts owed, payment status, billing details, and integration state with external accounting systems.

Invoices can be in draft or final state. A draft invoice (“Draft true) can still be modified before being finalised. Once finalised, an invoice number is assigned and the invoice can be sent to the customer.

An invoice may also be a credit note (CreditNote` true`), which references the original invoice via OriginalInvoiceGuid“ and represents a reversal or adjustment.

Payment status is tracked via Paid, PaidAmount, and PaidOn. Partial payments are possible — compare PaidAmount against TotalAmount to determine outstanding balance. Refunds are tracked separately via Refunded, RefundedOn, and RefundedAmount.

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

Enums

eStorecoveInvoiceStatus — StorecoveInvoiceStatus values

Value	Name
1	None
2	TransferFailed
3	Processing
4	ProcessingFailed
5	Processed

Query Parameters

Pagination & Sorting

page · integer · default: "1"

The page number to retrieve.

size · integer · default: "25"

The number of records per page.

orderBy · string

The property name to sort results by (e.g. Name, CreatedOn).

dir · integer

Sort direction. 0 for ascending, 1 for descending.

Filters

CoworkerInvoice_Coworker · integer

Filter by iD of the coworker linked to this record.

CoworkerInvoice_Coworker_FullName · string

Filter by full name of the invoiced customer.

CoworkerInvoice_Coworker_RegularPaymentContractNumber · string

Filter by the coworker regular payment contract number value for this coworker invoice.

CoworkerInvoice_Coworker_RegularPaymentProvider · string

Filter by the coworker regular payment provider value for this coworker invoice.

CoworkerInvoice_Coworker_CardNumber · string

Filter by the coworker card number value for this coworker invoice.

CoworkerInvoice_Coworker_GoCardlessContractNumber · string

Filter by the coworker go cardless contract number value for this coworker invoice.

CoworkerInvoice_Coworker_EnableGoCardlessPayments · boolean

Filter by whether coworker enable go cardless payments is enabled.

CoworkerInvoice_Coworker_BillingEmail · string

Filter by billing email address of the customer.

CoworkerInvoice_Coworker_NotifyOnNewInvoice · boolean

Filter by whether coworker notify on new invoice is enabled.

CoworkerInvoice_Coworker_NotifyOnNewPayment · boolean

Filter by whether coworker notify on new payment is enabled.

CoworkerInvoice_Coworker_NotifyOnFailedPayment · boolean

Filter by whether coworker notify on failed payment is enabled.

CoworkerInvoice_Coworker_DoNotProcessInvoicesAutomatically · boolean

Filter by whether coworker do not process invoices automatically is enabled.

CoworkerInvoice_Coworker_CompanyName · string

Filter by company name of the invoiced customer.

CoworkerInvoice_Coworker_TeamNames · string

Filter by team names the invoiced customer belongs to.

CoworkerInvoice_Business · integer

Filter by iD of the business linked to this record.

CoworkerInvoice_Business_Name · string

Filter by name of the location that issued the invoice.

CoworkerInvoice_InvoiceNumber · string

Filter by unique invoice number assigned when the invoice is finalised.

CoworkerInvoice_PaymentReference · string

Filter by reference code used to match payments to this invoice.

CoworkerInvoice_BillToName · string

Filter by name of the person or company being billed.

CoworkerInvoice_BillToAddress · string

Filter by billing address on the invoice.

CoworkerInvoice_BillToCity · string

Filter by billing city on the invoice.

CoworkerInvoice_BillToPostCode · string

Filter by billing post code on the invoice.

CoworkerInvoice_BillToPhone · string

Filter by billing phone number on the invoice.

CoworkerInvoice_BillToFax · string

Filter by billing fax number on the invoice.

CoworkerInvoice_BillToState · string

Filter by billing state or region on the invoice.

CoworkerInvoice_BillToCountry · integer

Filter by iD of the bill to country linked to this record.

CoworkerInvoice_BillToCountry_Name · string

Filter by name of the billing country on the invoice.

CoworkerInvoice_BillToCountry_TwoDigitsCode · string

Filter by the bill to country two digits code value for this coworker invoice.

CoworkerInvoice_BillToBankAccount · string

Filter by bank account number on the invoice for payment.

CoworkerInvoice_BillToTaxIDNumber · string

Filter by tax identification number of the billed party.

CoworkerInvoice_PurchaseOrder · string

Filter by customer purchase order number for this invoice.

CoworkerInvoice_Description · string

Filter by free-text description or notes for the invoice.

CoworkerInvoice_DiscountAmount · number

Filter by discount amount applied to the invoice total.

CoworkerInvoice_DueDate · string

Filter by date by which payment is due.

CoworkerInvoice_InvoiceFromDate · string

Filter by start date of the billing period covered by this invoice.

CoworkerInvoice_InvoiceToDate · string

Filter by end date of the billing period covered by this invoice.

CoworkerInvoice_TotalAmount · number

Filter by total invoice amount including tax.

CoworkerInvoice_PaidAmount · number

Filter by total amount paid against this invoice so far.

CoworkerInvoice_TransactionTotalAmount · number

Filter by the transaction total amount value for this coworker invoice.

CoworkerInvoice_TransactionCurrency · integer

Filter by iD of the transaction currency linked to this record.

CoworkerInvoice_TransactionCurrency_Code · string

Filter by the transaction currency code value for this coworker invoice.

CoworkerInvoice_TransactionExchangeRate · number

Filter by the transaction exchange rate value for this coworker invoice.

CoworkerInvoice_Currency · integer

Filter by iD of the currency linked to this record.

CoworkerInvoice_Currency_Code · string

Filter by iSO currency code (e.g. USD, EUR, GBP).

CoworkerInvoice_TaxAmount · number

Filter by total tax amount on the invoice.

CoworkerInvoice_Draft · boolean

Filter by whether the invoice is still a draft. Draft invoices can be modified before finalisation.

CoworkerInvoice_Void · boolean

Filter by whether the invoice has been voided (cancelled without a credit note).

CoworkerInvoice_WaitingForInvoiceNumber · boolean

Filter by whether the invoice is queued for invoice number assignment.

CoworkerInvoice_Paid · boolean

Filter by whether the invoice has been fully paid.

CoworkerInvoice_Sent · boolean

Filter by whether the invoice has been emailed to the customer.

CoworkerInvoice_SentOn · string

Filter by date the invoice was emailed to the customer.

CoworkerInvoice_PaidOn · string

Filter by date the invoice was marked as fully paid.

CoworkerInvoice_Refunded · boolean

Filter by whether a refund has been issued for this invoice.

CoworkerInvoice_XeroInvoiceTransfered · boolean

Filter by whether the invoice has been transferred to Xero.

CoworkerInvoice_XeroPaymentTransfered · boolean

Filter by whether the payment has been transferred to Xero.

CoworkerInvoice_QuickbooksInvoiceTransfered · boolean

Filter by whether the invoice has been transferred to QuickBooks.

CoworkerInvoice_QuickbooksPaymentTransfered · boolean

Filter by whether the payment has been transferred to QuickBooks.

CoworkerInvoice_MoloniInvoiceTransferred · boolean

Filter by whether the invoice has been transferred to Moloni.

CoworkerInvoice_MoloniPaymentTransferred · boolean

Filter by whether the payment has been transferred to Moloni.

CoworkerInvoice_StorecoveInvoiceStatus · integer

Filter by status of e-invoicing transfer via Storecove.

CoworkerInvoice_AutoTransferToStorecove · boolean

Filter by whether the invoice is automatically sent to Storecove for e-invoicing.

CoworkerInvoice_StorecoveUniqueId · string

Filter by iD of the storecove unique associated with this record.

CoworkerInvoice_RefundedOn · string

Filter by date the refund was issued.

CoworkerInvoice_CreditNote · boolean

Filter by whether this document is a credit note rather than an invoice.

CoworkerInvoice_OriginalInvoiceGuid · string

Filter by gUID of the original invoice this credit note reverses.

CoworkerInvoice_ContractGuid · string

Filter by gUID of the contract that generated this invoice.

CoworkerInvoice_CustomData · string

Filter by arbitrary custom data stored with the invoice.

CoworkerInvoice_GoCardlessReference · string

Filter by goCardless payment reference for direct debit collection.

CoworkerInvoice_SpreedlyToken · string

Filter by the spreedly token value for this coworker invoice.

CoworkerInvoice_LastPaymentAttempt · string

Filter by date/time value for last payment attempt.

CoworkerInvoice_Billed · boolean

Filter by whether billed is enabled.

CoworkerInvoice_DoNotApplyCreditAutomatically · boolean

Filter by whether to skip automatic application of available credit to this invoice.

CoworkerInvoice_CreatedOnLocal · string

Filter by date/time value for created on local.

CoworkerInvoice_DueDateLocal · string

Filter by date/time value for due date local.

CoworkerInvoice_InvoiceFromDateLocal · string

Filter by date/time value for invoice from date local.

CoworkerInvoice_InvoiceToDateLocal · string

Filter by date/time value for invoice to date local.

CoworkerInvoice_PaidOnLocal · string

Filter by date/time value for paid on local.

CoworkerInvoice_RefundedOnLocal · string

Filter by date/time value for refunded on local.

CoworkerInvoice_LastPaymentAttemptLocal · string

Filter by date/time value for last payment attempt local.

CoworkerInvoice_ReceivedAmount · number

Filter by total amount received via direct payments.

CoworkerInvoice_CreditedAmount · number

Filter by amount paid via credit notes or account credit.

CoworkerInvoice_RefundedAmount · number

Filter by total amount refunded on this invoice.

CoworkerInvoice_NexKioskTransactionId · string

Filter by transaction ID from NexKiosk point-of-sale payment.

CoworkerInvoice_AutoTransferToXeroOrQuickBooks · boolean

Filter by whether the invoice is automatically transferred to Xero or QuickBooks.

Range Filters

from_CoworkerInvoice_DiscountAmount · number

Filter by discount amount applied to the invoice total greater than or equal to this value.

to_CoworkerInvoice_DiscountAmount · number

Filter by discount amount applied to the invoice total less than or equal to this value.

from_CoworkerInvoice_DueDate · string

Filter by date by which payment is due greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.

to_CoworkerInvoice_DueDate · string

Filter by date by which payment is due less than or equal to this value. Format: YYYY-MM-DDTHH:mm.

from_CoworkerInvoice_InvoiceFromDate · string

Filter by start date of the billing period covered by this invoice greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.

to_CoworkerInvoice_InvoiceFromDate · string

Filter by start date of the billing period covered by this invoice less than or equal to this value. Format: YYYY-MM-DDTHH:mm.

from_CoworkerInvoice_InvoiceToDate · string

Filter by end date of the billing period covered by this invoice greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.

to_CoworkerInvoice_InvoiceToDate · string

Filter by end date of the billing period covered by this invoice less than or equal to this value. Format: YYYY-MM-DDTHH:mm.

from_CoworkerInvoice_TotalAmount · number

Filter by total invoice amount including tax greater than or equal to this value.

to_CoworkerInvoice_TotalAmount · number

Filter by total invoice amount including tax less than or equal to this value.

from_CoworkerInvoice_PaidAmount · number

Filter by total amount paid against this invoice so far greater than or equal to this value.

to_CoworkerInvoice_PaidAmount · number

Filter by total amount paid against this invoice so far less than or equal to this value.

from_CoworkerInvoice_TransactionTotalAmount · number

Filter by the transaction total amount value for this coworker invoice greater than or equal to this value.

to_CoworkerInvoice_TransactionTotalAmount · number

Filter by the transaction total amount value for this coworker invoice less than or equal to this value.

from_CoworkerInvoice_TransactionExchangeRate · number

Filter by the transaction exchange rate value for this coworker invoice greater than or equal to this value.

to_CoworkerInvoice_TransactionExchangeRate · number

Filter by the transaction exchange rate value for this coworker invoice less than or equal to this value.

from_CoworkerInvoice_TaxAmount · number

Filter by total tax amount on the invoice greater than or equal to this value.

to_CoworkerInvoice_TaxAmount · number

Filter by total tax amount on the invoice less than or equal to this value.

from_CoworkerInvoice_SentOn · string

Filter by date the invoice was emailed to the customer greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.

to_CoworkerInvoice_SentOn · string

Filter by date the invoice was emailed to the customer less than or equal to this value. Format: YYYY-MM-DDTHH:mm.

from_CoworkerInvoice_PaidOn · string

Filter by date the invoice was marked as fully paid greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.

to_CoworkerInvoice_PaidOn · string

Filter by date the invoice was marked as fully paid less than or equal to this value. Format: YYYY-MM-DDTHH:mm.

from_CoworkerInvoice_RefundedOn · string

Filter by date the refund was issued greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.

to_CoworkerInvoice_RefundedOn · string

Filter by date the refund was issued less than or equal to this value. Format: YYYY-MM-DDTHH:mm.

from_CoworkerInvoice_LastPaymentAttempt · string

Filter by date/time value for last payment attempt greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.

to_CoworkerInvoice_LastPaymentAttempt · string

Filter by date/time value for last payment attempt less than or equal to this value. Format: YYYY-MM-DDTHH:mm.

from_CoworkerInvoice_CreatedOnLocal · string

Filter by date/time value for created on local greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.

to_CoworkerInvoice_CreatedOnLocal · string

Filter by date/time value for created on local less than or equal to this value. Format: YYYY-MM-DDTHH:mm.

from_CoworkerInvoice_DueDateLocal · string

Filter by date/time value for due date local greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.

to_CoworkerInvoice_DueDateLocal · string

Filter by date/time value for due date local less than or equal to this value. Format: YYYY-MM-DDTHH:mm.

from_CoworkerInvoice_InvoiceFromDateLocal · string

Filter by date/time value for invoice from date local greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.

to_CoworkerInvoice_InvoiceFromDateLocal · string

Filter by date/time value for invoice from date local less than or equal to this value. Format: YYYY-MM-DDTHH:mm.

from_CoworkerInvoice_InvoiceToDateLocal · string

Filter by date/time value for invoice to date local greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.

to_CoworkerInvoice_InvoiceToDateLocal · string

Filter by date/time value for invoice to date local less than or equal to this value. Format: YYYY-MM-DDTHH:mm.

from_CoworkerInvoice_PaidOnLocal · string

Filter by date/time value for paid on local greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.

to_CoworkerInvoice_PaidOnLocal · string

Filter by date/time value for paid on local less than or equal to this value. Format: YYYY-MM-DDTHH:mm.

from_CoworkerInvoice_RefundedOnLocal · string

Filter by date/time value for refunded on local greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.

to_CoworkerInvoice_RefundedOnLocal · string

Filter by date/time value for refunded on local less than or equal to this value. Format: YYYY-MM-DDTHH:mm.

from_CoworkerInvoice_LastPaymentAttemptLocal · string

Filter by date/time value for last payment attempt local greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.

to_CoworkerInvoice_LastPaymentAttemptLocal · string

Filter by date/time value for last payment attempt local less than or equal to this value. Format: YYYY-MM-DDTHH:mm.

from_CoworkerInvoice_ReceivedAmount · number

Filter by total amount received via direct payments greater than or equal to this value.

to_CoworkerInvoice_ReceivedAmount · number

Filter by total amount received via direct payments less than or equal to this value.

from_CoworkerInvoice_CreditedAmount · number

Filter by amount paid via credit notes or account credit greater than or equal to this value.

to_CoworkerInvoice_CreditedAmount · number

Filter by amount paid via credit notes or account credit less than or equal to this value.

from_CoworkerInvoice_RefundedAmount · number

Filter by total amount refunded on this invoice greater than or equal to this value.

to_CoworkerInvoice_RefundedAmount · number

Filter by total amount refunded on this invoice less than or equal to this value.

from_CoworkerInvoice_CreatedOn · string

Filter records created on or after this date. Format: YYYY-MM-DDTHH:mm.

to_CoworkerInvoice_CreatedOn · string

Filter records created on or before this date. Format: YYYY-MM-DDTHH:mm.

from_CoworkerInvoice_UpdatedOn · string

Filter records updated on or after this date. Format: YYYY-MM-DDTHH:mm.

to_CoworkerInvoice_UpdatedOn · string

Filter records updated on or before this date. Format: YYYY-MM-DDTHH:mm.

Code Examples

Simple listing

cURL

curl -X GET \
  "https://spaces.nexudus.com/api/billing/coworkerinvoices?page=1&size=15&orderBy=InvoiceNumber&dir=0" \
  -H "Authorization: Bearer YOUR_TOKEN"

Filtering by InvoiceNumber

cURL

curl -X GET \
  "https://spaces.nexudus.com/api/billing/coworkerinvoices?CoworkerInvoice_InvoiceNumber=example-value&orderBy=InvoiceNumber&dir=0" \
  -H "Authorization: Bearer YOUR_TOKEN"

Range filters

cURL

curl -X GET \
  "https://spaces.nexudus.com/api/billing/coworkerinvoices?from_CoworkerInvoice_UpdatedOn=2025-01-01T00:00&to_CoworkerInvoice_UpdatedOn=2025-12-31T23:59&orderBy=UpdatedOn&dir=0" \
  -H "Authorization: Bearer YOUR_TOKEN"

Response

200

Records · CoworkerInvoice[]

The list of CoworkerInvoice records matching the query. See the Get one CoworkerInvoice endpoint for the full list of properties returned for each record.

CurrentPage · integer

Current page number.

CurrentPageSize · integer

Number of records per page.

CurrentOrderField · string

The field used for sorting.

CurrentSortDirection · integer

The sort direction (0 = ascending, 1 = descending).

FirstItem · integer

Index of the first item on the current page.

LastItem · integer

Index of the last item on the current page.

TotalItems · integer

Total number of matching records across all pages.

TotalPages · integer

Total number of pages.

HasNextPage · boolean

Whether there is a next page of results.

HasPreviousPage · boolean

Whether there is a previous page of results.

Example Response

{
  "Records": [
    {
      "CoworkerId": 0,
      "CoworkerFullName": null,
      "CoworkerRegularPaymentContractNumber": null,
      "CoworkerRegularPaymentProvider": null,
      "CoworkerCardNumber": null,
      "CoworkerGoCardlessContractNumber": null,
      "CoworkerEnableGoCardlessPayments": null,
      "CoworkerBillingEmail": null,
      "CoworkerNotifyOnNewInvoice": null,
      "CoworkerNotifyOnNewPayment": null,
      "CoworkerNotifyOnFailedPayment": null,
      "CoworkerDoNotProcessInvoicesAutomatically": null,
      "CoworkerCompanyName": null,
      "CoworkerTeamNames": null,
      "BusinessId": 0,
      "BusinessName": null,
      "InvoiceNumber": "",
      "PaymentReference": null,
      "BillToName": "",
      "BillToAddress": "",
      "BillToCity": "",
      "BillToPostCode": "",
      "BillToPhone": null,
      "BillToFax": null,
      "BillToState": null,
      "BillToCountryId": 0,
      "BillToCountryName": null,
      "BillToCountryTwoDigitsCode": null,
      "BillToBankAccount": null,
      "BillToTaxIDNumber": null,
      "PurchaseOrder": null,
      "Description": null,
      "DiscountAmount": 0,
      "DueDate": null,
      "InvoiceFromDate": null,
      "InvoiceToDate": null,
      "TotalAmount": 0,
      "PaidAmount": null,
      "TransactionTotalAmount": null,
      "TransactionCurrencyId": null,
      "TransactionCurrencyCode": null,
      "TransactionExchangeRate": null,
      "CurrencyId": 0,
      "CurrencyCode": null,
      "TaxAmount": 0,
      "Draft": false,
      "Void": false,
      "WaitingForInvoiceNumber": false,
      "Paid": false,
      "Sent": false,
      "SentOn": null,
      "PaidOn": null,
      "Refunded": false,
      "XeroInvoiceTransfered": false,
      "XeroPaymentTransfered": false,
      "QuickbooksInvoiceTransfered": false,
      "QuickbooksPaymentTransfered": false,
      "MoloniInvoiceTransferred": false,
      "MoloniPaymentTransferred": false,
      "StorecoveInvoiceStatus": 0,
      "AutoTransferToStorecove": false,
      "StorecoveUniqueId": null,
      "RefundedOn": null,
      "CreditNote": false,
      "OriginalInvoiceGuid": null,
      "ContractGuid": null,
      "CustomData": null,
      "GoCardlessReference": null,
      "SpreedlyToken": null,
      "LastPaymentAttempt": null,
      "Billed": false,
      "DoNotApplyCreditAutomatically": false,
      "CreatedOnLocal": null,
      "DueDateLocal": null,
      "InvoiceFromDateLocal": null,
      "InvoiceToDateLocal": null,
      "PaidOnLocal": null,
      "RefundedOnLocal": null,
      "LastPaymentAttemptLocal": null,
      "ReceivedAmount": null,
      "CreditedAmount": null,
      "RefundedAmount": null,
      "NexKioskTransactionId": null,
      "AutoTransferToXeroOrQuickBooks": false,
      "Id": 87654321,
      "UpdatedOn": "2025-01-15T10:30:00Z",
      "CreatedOn": "2025-01-10T08:00:00Z",
      "UniqueId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "UpdatedBy": "[e-mail]",
      "IsNew": false,
      "SystemId": null,
      "ToStringText": "CoworkerInvoice Example",
      "LocalizationDetails": null,
      "CustomFields": null
    }
  ],
  "CurrentPageSize": 15,
  "CurrentPage": 1,
  "CurrentOrderField": "InvoiceNumber",
  "CurrentSortDirection": 1,
  "FirstItem": 1,
  "HasNextPage": false,
  "HasPreviousPage": false,
  "LastItem": 1,
  "PageNumber": 1,
  "PageSize": 15,
  "TotalItems": 1,
  "TotalPages": 1
}