ADM-TRANSACTION-550 - List transactions with search, filters and sorting

get

https://api.djust-app.com/v1/transactions

Returns a paginated, searchable, filterable, and sortable list of commercial transactions processed via DJUST Pay.

User scoping

OPERATOR clients only for this route.

Visibility

OPERATOR can access all transactions across all suppliers.

Scope

One row equals one commercial transaction related to a commercial order.
Includes transactions coming from multiple PSPs.
Provides the fields required to display the Transactions list and navigate to transaction details.
updatedAt is the timestamp of the latest payment status update and is used as the default ordering field.

Search

Optional text search applied on commercial order references, customer account (name, externalId), PSP reference and last eventId.

Filters

AND between different keys; OR between values of the same key.
Supported filters: paymentMethods, status, customerAccountIds, amountMin, amountMax, updatedAtFrom, updatedAtTo.

Sorting

Sorting expression following the format: <field>:<direction>.
Allowed properties: updatedAt, amount, status, commercialOrderReference.
Default sort: updatedAt:desc.
Invalid sorts are silently ignored.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

string

Optional text search applied on key transaction fields.

customerAccountIds

array of strings

Multi-valued filter on customer account external ids.

customerAccountIds

paymentMethods

array of strings

Multi-valued filter on payment methods.

paymentMethods

amountMin

float

Minimum order amount (inclusive).

amountMax

float

Maximum order amount (inclusive).

status

array of strings

Multi-valued filter on transaction status.

status

updatedAtFrom

date-time

Return transactions updated on or after this ISO date-time (inclusive).

updatedAtTo

date-time

Return transactions updated on or before this ISO date-time (inclusive).

sort

string

Supported fields: amount, status, commercialOrderReference, updatedAt.
Default sort: updatedAt:desc.

page

integer

Page number.

size

integer

Page size.

Headers

dj-client

string

enum

required

Must be set to OPERATOR for this administration route.

Allowed:

dj-api-key

string

required

API key for authentication.

dj-store

string

Optional store context.

dj-store-view

string

Optional store view context.

Responses

401

Unauthorized (invalid or missing API key)

403

Forbidden (insufficient permissions)

404

Not found (unknown reference)

500

Internal server error

200Transaction list successfully retrieved.