Get all transactionList in Company

post

https://api.embermind.ch/api/v1/client/transactions/get-list

Get paginated list of transactions with filtering by date range, score, status, card tokens, fingerprints and other attributes

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

page

number

> 0

Page number (starts from 1)

perPage

number

0 to 500

Number of items per page (default 25, max 500)

sortBy

string

enum

required

Sort field

sortDirection

string

enum

required

Sort direction (ASC/DESC)

Allowed:

periodStart

date-time

Filter period start date. Required unless transactionIdList is provided.

periodEnd

date-time

Filter period end date. Required unless transactionIdList is provided.

asOf

date-time

AD-2914: shared reference instant (ISO) for resolving the virtual LONG_PENDING status. Pass the same value to the Long-pending card, header totals and the list so their counts match (LONG_PENDING is computed relative to this instant bucketed to the minute, minus the company threshold). Defaults to server now when omitted.

scoreMin

number

Minimum score filter. Required unless transactionIdList is provided.

scoreMax

number

Maximum score filter. Required unless transactionIdList is provided.

transactionIdList

array of uuids

length ≤ 1000

Restrict the list to the given transaction ids. The first 200 ids are used (excess is truncated server-side, not rejected) to keep ClickHouse cost bounded. When set, periodStart/periodEnd/scoreMin/scoreMax may be omitted.

transactionIdList

searchValue

string

Search query

currency

string

Currency filter

statusList

array of strings

Transaction status filter (LONG_PENDING — virtual: PENDING longer than company threshold)

statusList

Allowed:

cardTokenList

array of strings

Card token filter

cardTokenList

fingerprintList

array of strings

Fingerprint filter

fingerprintList

emailList

array of strings

Email filter — exact match on any listed value. Distinct from emailSearchValue, which is a substring search: this is the target of the transaction-graph "show transactions carrying this value" hand-off, where the value is already known exactly

emailList

phoneList

array of strings

Phone filter — exact match on any listed value. Distinct from phoneSearchValue, which is a substring search

phoneList

ipAddressList

array of strings

IP address filter — exact match on any listed value. Distinct from ipAddressSearchValue, which is a substring search

ipAddressList

binList

array of strings

BIN filter

binList

gateIdList

array of uuids

Gate ID filter

gateIdList

countryList

array of strings

Country filter

countryList

merchantIdList

array of uuids

Merchant ID filter

merchantIdList

merchantAccountIdList

array of uuids

Merchant account ID filter

merchantAccountIdList

customerIdList

array of uuids

Customer ID filter

customerIdList

bankIdList

array of uuids

Bank ID filter

bankIdList

cascadeIdList

array of uuids

Cascade ID filter

cascadeIdList

cardBinBankList

array of strings

Card BIN bank filter

cardBinBankList

isHasChargeback

boolean

Filter transactions with chargeback

isHasFraud

boolean

Filter transactions with fraud

isHasRefund

boolean

Filter transactions with refund

isHasNote

boolean

Filter transactions with notes

isShowIntermediateGates

boolean

Show transactions where selected gates got decline but were not final in the cascade (intermediate attempts)

emailSearchValue

string

Email search filter

phoneSearchValue

string

Phone search filter

cardFullSearchValue

string

Card number search filter

cardTokenSearchValue

string

Card token search filter

cardHolderSearchValue

string

Cardholder name search filter

amountMin

number

Minimum amount filter

amountMax

number

Maximum amount filter

feePercentMin

number

Minimum fee percent filter

feePercentMax

number

Maximum fee percent filter

avgScoreMin

number

Minimum average score filter

avgScoreMax

number

Maximum average score filter

ipAddressSearchValue

string

IP address search filter

addressFullSearchValue

string

Full address search filter

transactionTypeList

array of strings

Transaction type filter

transactionTypeList

Allowed:

transactionPaymentMethodSearchValue

string

Payment method search filter

declineTypeFilter

string

enum

Decline type filter: ALL - all declines (default), BANK - bank declines only, SYSTEM - system declines only

Allowed:

transactionGateDeclineByWhenDeclineList

array of strings

Apply ONLY to transactions with DECLINE status, without excluding other statuses

transactionGateDeclineByWhenDeclineList

Allowed:

Headers

x-access-token

string

x-api-key

string

Responses

200Response

400Invalid filter or pagination parameters

401Invalid or missing authentication

500Database error