List transactions
Retrieve matching transactions.
Path parameters
Query parameters
Filter expenses by id. Use operator.value syntax.
eq, neq, in, is operators
eq.01JQ2T5Y5Q3R8W9N6M4K2H7P1AFilter expenses by amount. Use operator.value syntax.
eq, neq, gt, gte, lt, lte operators
eq.100.00Filter expenses by direction. Use operator.value syntax.
eq, neq, in, is operators
eq.inboundFilter expenses by createdAt. Use operator.value syntax.
eq, neq, gt, gte, lt, lte, is operators
eq.2026-01-15T12:00:00ZFilter expenses by bankAccountId. Use operator.value syntax.
eq, neq, in, is operators
eq.01JQ2T5Y5Q3R8W9N6M4K2H7P1AFilter expenses by originalId. Use operator.value syntax.
eq, neq, gt, gte, lt, lte, in, is operators
eq.01JQ2T5Y5Q3R8W9N6M4K2H7P1AFilter expenses by sourceId. Use operator.value syntax.
eq, neq, in, is operators
eq.01JQ2T5Y5Q3R8W9N6M4K2H7P1AFilter expenses by sourceType. Use operator.value syntax.
eq, neq, in operators
eq.invoiceFilter expenses by currencyCode. Use operator.value syntax.
eq, neq, in, is operators
eq.SARComma-separated fields. Select a declared relation with relation(field,field).
declared fields and relations only
id,sourceOrder by field.asc or field.desc. Repeat fields with commas.
repeat fields separated by commas
id.asc,amount.ascMaximum records returned. Defaults to 25.
1 to 1000
25Opaque continuation cursor returned by the previous page.
opaque-cursorRequest an exact count. This may cost more than a normal page.
exact
exactSearch matching resource fields.
consultingQuery options
Use filter, select, order, limit, cursor, count, search. The default limit is 25; the maximum is 1000.
Filterable: id, amount, direction, createdAt, bankAccountId, originalId, sourceId, sourceType, currencyCode.
Selectable: id, source, amount, direction, currency, createdAt, bankAccountId, accountLabel, originalId, context.
Sortable: id, amount, direction, createdAt, bankAccountId, originalId, sourceId, sourceType, currencyCode.
Errors: invalid_input, query_invalid, unauthenticated, not_found, forbidden, plan_limit, conflict, rate_limited, request_quota, unavailable, internal_error.
Headers
Bearer workspace API key.
Bearer $NQD_API_KEYWorkspace scope for the request. Required for workspace operations and must belong to the authenticated identity.
Minimum length: 1 character. · Maximum length: 128 characters.
01JQ2T5Y5Q3R8W9N6M4K2H7P1AFinancial sources describe what the money or wealth represents: Invoice, Income, Expense, Payout, and Asset.
Transactions describe cash events against a source. A source can be unpaid or partially paid; a Transaction records an actual cash movement.
Payment status and settlement dates come from Transactions; source headers do not accept a separate paidAt value.
Response
Response headers
Returned records. Collections and batches use an array; single records use an object.
ShowHide 10 properties
Opaque identifier for this resource or reference.
01JQ2T5Y5Q3R8W9N6M4K2H7P1Rsource for this expense.
Exact decimal string used for financial calculations. Do not round or convert it to a display number.
100.00direction for this expense.
Allowed values: "inbound", "outbound"
outboundReferenced currency with its opaque ID and ISO 4217 currency code.
ShowHide 3 properties
Opaque identifier for this resource or reference.
Minimum length: 1 character. · Maximum length: 128 characters.
01JQ2T5Y5Q3R8W9N6M4K2H7P1FISO 4217 currency code, such as SAR or USD.
Minimum length: 1 character. · Maximum length: 128 characters.
SARCurrency conversion quote used for reporting, including source, target, and rate.
ShowHide 3 properties
ISO 4217 code of the source currency in this persisted quote.
Minimum length: 1 character. · Maximum length: 128 characters.
SARISO 4217 code of the target reporting currency in this persisted quote.
Minimum length: 1 character. · Maximum length: 128 characters.
SARExact decimal conversion rate from the quote source currency to its target currency.
Maximum length: 128 characters.
1.00ID of the related bank account.
nullaccount label for this expense.
Consulting servicesID of the related original.
Consulting servicescontext for this expense.
ISO 8601 timestamp for the authored or payment event. Recurring records preserve their scheduled occurrence.
2026-01-15T12:00:00.000ZPagination metadata for the returned records, or the current page number when this endpoint uses numbered pages.
ShowHide 4 properties
Maximum number of records to return for this page.
1Whether another page is available.
falseOpaque cursor for the next page, or null when there is no next page.
nullTotal number of records that match the request.
1Possible errors
Response headers
Error details returned for a failed request.
ShowHide 4 properties
Stable machine-readable error or resource code.
invalid_inputHuman-readable explanation of the result or error.
The request could not be validated.Correlation identifier for support and request tracing.
550e8400-e29b-41d4-a716-446655440000Additional structured details about the result or error.
ShowHide 1 property
Structured field issues returned when request validation fails.
ShowHide 3 properties
Field path where the validation issue occurred.
One of: string alternative 1, number alternative 2
0 itemsMachine-readable reason for the validation issue.
Allowed values: "expected_type", "required", "unexpected_property", "invalid_value", "invalid_json", "invalid_query", "unsupported_media_type", "body_too_large", "body_timeout", "conflicting_scope", "missing_header", "concurrency_required", "invalid_resource_id", "invalid_request"
invalid_requestStable machine-readable error or resource code.
invalid_input{
"error": {
"code": "invalid_input",
"message": "The request could not be validated.",
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"details": {
"issues": [
{
"path": [],
"reason": "invalid_request"
}
]
}
}
}View raw OpenAPI operation
Use the machine-readable contract for client generation and payload validation.
Open OpenAPI contract ↗