TransactionsTransactions

List transactions in a date range

post/v1/transactions/list

Returns a cursor-paginated page of transactions for the caller's reseller between fromDate and toDate (calendar dates in the caller's timezone), newest first. For API key callers the reseller is always taken from the key; a different resellerId in the body is rejected with 403.

Endpoint destination URL

https://sandbox-portal.datmanlabs.com/api/v1/transactions/list

Authorization

ApiKeyAuth
headerapi_key<token>

Partner API key issued by Datman.

Request Parameters

Request Body

application/json
  1. body
fromDate*string

Start calendar date (YYYY-MM-DD), inclusive, in the request timezone.

Match^\d{4}-\d{2}-\d{2}$
toDate*string

End calendar date (YYYY-MM-DD), inclusive, in the request timezone.

Match^\d{4}-\d{2}-\d{2}$
limit?number

Page size. Values above 50 are rejected with 422.

Rangevalue <= 50
Default25
cursor?string

The pagination.nextCursor value from a previous page.

status?array<>

Only return transactions with these statuses.

merchantId?integer

Restrict to one merchant. Non-integer values are ignored.

timezone?string

IANA timezone used to interpret the dates and render timestamps. Defaults to Europe/London.

resellerId?integer

Optional for API key callers (the key's reseller is always used); if supplied it must match, otherwise 403.

Response parameters & Errors

Response Body

A page of transactions. When the reseller has no configuration an empty page is returned (without data.timezone). When merchantId refers to a liable merchant the body also carries isLiable: true.

application/json
  1. response
data*
pagination*
isLiable?boolean

Present (true) only when merchantId is a liable merchant.