Skip to main content
GET
List Transactions

Authorizations

​
Authorization
string
header
required

Bearer token authentication, for client-server calls.

Send the access token issued by POST /v1/auth/token as Authorization: Bearer {token}. The token carries its own program and user context, so the X-Meridian-* headers are not required. See Authentication.

Headers

​
X-Meridian-Api-Key
string

Server-to-server (HMAC) requests only. Partner API key issued by Meridian during provisioning.

​
X-Meridian-Timestamp
string

Server-to-server (HMAC) requests only. Current time in milliseconds since the Unix epoch. Must be within 60 seconds of the request.

​
X-Meridian-Program-Id
string

Server-to-server (HMAC) requests only. Identifies the program context for the request.

​
X-Meridian-User-Id
string

Server-to-server (HMAC) requests only. Identifies the Meridian user targeted by the request. Required for MULTI_USER integrations; omit for SINGLE_USER.

Query Parameters

​
accountId
string

Restrict the listing to one account: the id returned by GET /v1/accounts. Transactions on that account's sub-balances are included, so a stablecoin deposit and the internal sweep that moves it to the account both appear. Omit to list every transaction in the program.

​
pageIndex
string

Zero-based page to return. Defaults to 0.

​
pageSize
string

Records per page, between 1 and 200. Defaults to 25. Use this to fetch a short recent-activity list, for example pageSize=5.

​
sortBy
string

Field to sort on: CREATED_AT, UPDATED_AT, STATUS or TYPE. Omit it for CREATED_AT; any other value is rejected with 400 rather than falling back, so a typo cannot silently reorder the listing. Ties are broken by id, so paging is stable. To sync changes, request sortBy=UPDATED_AT&sortDirection=ASC&pageIndex=0 with minUpdatedAt set to the latest updatedAt already seen, skip ids already seen (minUpdatedAt is inclusive), and repeat until a page comes back short. Moving minUpdatedAt rather than pageIndex means a transaction that changes mid-sync is returned again instead of shifting another one out of view. If a full page shares one updatedAt, the cursor cannot move: page through that timestamp with minUpdatedAt and maxUpdatedAt both set to it and increasing pageIndex until a page comes back short, then continue from it as before.

​
sortDirection
string

Sort direction: ASC or DESC. Omit it for DESC, so the newest transaction comes first; any other value is rejected with 400 rather than falling back.

​
minCreatedAt
string

Only transactions created at or after this instant. ISO-8601 timestamp with a Z or a URL-encoded offset, e.g. 2026-09-28T00:00:00Z.

​
maxCreatedAt
string

Only transactions created at or before this instant. ISO-8601 timestamp with a Z or a URL-encoded offset, e.g. 2026-09-28T00:00:00Z.

​
minUpdatedAt
string

Only transactions last changed at or after this instant. ISO-8601 timestamp with a Z or a URL-encoded offset, e.g. 2026-09-28T00:00:00Z.

​
maxUpdatedAt
string

Only transactions last changed at or before this instant. ISO-8601 timestamp with a Z or a URL-encoded offset, e.g. 2026-09-28T00:00:00Z.

​
minCompletedAt
string

Only transactions completed at or after this instant. ISO-8601 timestamp with a Z or a URL-encoded offset, e.g. 2026-09-28T00:00:00Z.

​
maxCompletedAt
string

Only transactions completed at or before this instant. ISO-8601 timestamp with a Z or a URL-encoded offset, e.g. 2026-09-28T00:00:00Z.

​
minCreditAmount
string

Only transactions whose creditAmount is at least this. Decimal amount, 0 or more. Set min and max to the same value for an exact amount.

​
maxCreditAmount
string

Only transactions whose creditAmount is at most this. Decimal amount, 0 or more. Set min and max to the same value for an exact amount.

​
minDebitAmount
string

Only transactions whose debitAmount is at least this. Decimal amount, 0 or more. Set min and max to the same value for an exact amount.

​
maxDebitAmount
string

Only transactions whose debitAmount is at most this. Decimal amount, 0 or more. Set min and max to the same value for an exact amount.

​
creditCurrency
string

Comma-separated creditCurrency values to match, e.g. USD,USDC_ETH.

​
debitCurrency
string

Comma-separated debitCurrency values to match, e.g. USD.

​
type
string

Comma-separated transaction types to match, e.g. DEPOSIT,WITHDRAWAL.

​
status
string

Comma-separated statuses to match, e.g. FAILED,RETURNED.

​
subtype
string

Comma-separated subtypes to match, e.g. INTERNAL_SWEEP.

​
debitRail
string

Comma-separated debitRail values as shown on a transaction, e.g. US.USD.ACH,US.USD.FEDWIRE or ETHEREUM.USDC.

​
creditRail
string

Comma-separated creditRail values as shown on a transaction, e.g. ETHEREUM.USDC.

​
purpose
string

Comma-separated payment purposes to match, e.g. SALARY.

​
referenceNumber
string

Exact referenceNumber, Meridian's reference for the transaction.

​
externalId
string

Exact externalId: the identifier you supplied as externalId when creating the transaction intent.

​
debitReference
string

Exact debitReference, the sender's reference on a deposit, e.g. an invoice number.

​
relatedTransactionId
string

Only transactions whose relatedTransactionId is this id, such as the return of a deposit.

​
payerBankCode
string

Exact debitParty.payer.bankCode, e.g. the ABA routing number of the sending bank.

​
beneficiaryId
string

Only payouts to this beneficiary: the id of creditParty.beneficiary.

​
payerDisplayName
string

Case-insensitive text contained in debitParty.payer.displayName, the deposit sender's name. At least 3 characters.

​
beneficiaryName
string

Case-insensitive text contained in the payout beneficiary's name (a business name, or first and last name). At least 3 characters.

Response

The transactions for the authenticated account

Transactions associated with the authenticated Meridian account

​
data
Transaction · object[]
required

List of transactions

​
pageIndex
integer
required

Current page index

Example:

0

​
pageSize
integer
required

Number of records per page

Example:

25

​
totalRecords
integer
required

Total number of records

Example:

8