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

get

https://example.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, paymentNetwork.

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

Allowed:

paymentNetworks

array of strings

Multi-valued filter on payment Network.

paymentNetworks

amountMin

number

Minimum order amount (inclusive).

amountMax

number

Maximum order amount (inclusive).

status

array of strings

Multi-valued filter on transaction status.

status

Allowed:

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).

lastEventStatus

array of strings

Multi-valued filter on event status. Unknown values are ignored.

lastEventStatus

lastEventId

string

Filter on the id of the latest event. No match returns empty.

createdAtFrom

date-time

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

createdAtTo

date-time

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

page

int32

Page number.

size

int32

Page size.

sort

array of strings

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

Format: property:direction (recommended) or property,direction (kept for backward compatibility).

sort

Headers

dj-client

string

enum

required

Specifies the client type making the request.

OPERATOR: Platform operator user.
ACCOUNT: Customer account user.
SUPPLIER: Supplier managing orders.

Allowed:

dj-api-key

string

required

API key required for authentication. Must be valid and linked to the requesting user.

dj-store

string

(Optional) Store ID in multi-store environments.

dj-store-view

string

(Optional) Store view ID in multi-store environments.

Responses

401

Unauthorized (invalid or missing API key).

403

Forbidden (insufficient permissions).

404

Not found (unknown reference).

500

Internal server error.

Language

Credentials

Bearer

JWT

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

*/*

200Transaction list successfully retrieved.