Skip to content

List transactions

Request

List organization transactions with optional filtering, search, sorting, and pagination. Supports both GET (bookmarkable, simple queries) and POST :list (complex filter objects as a JSON body).

Security
TokenAuth
Bodyapplication/jsonrequired
filterobject(v2TransactionFilter)

Optional filters: status, type, blockchain, asset_symbol, created_at range, updated_at range, qty range, origin, destination, transaction_id, transaction_hash, external_id, correlation_id. origin and destination match Address, wallet/address ID, or CounterpartyID; deprecated origin_address and destination_address match Address only. Each sub-filter is AND-ed.

paginationobject(v2FilterRequest)

Pagination and sorting. Sortable fields: created_at, updated_at, amount, status.

searchstring

Case-insensitive free-text search over transaction ID, transaction hash, external ID, correlation ID, asset symbol, origin address, and destination address.

Example:"0x55502b9d5a68b0F8a48384352295BeD968aD8AA4"
curl -i -X POST \
  https://docs.ripple.com/_mock/products/wallet/api-docs/palisade-api/palisade-api/v2/transactions:list \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "filter": {
      "status": {
        "eq": "REQUESTED",
        "notEq": "REQUESTED",
        "in": [
          "REQUESTED"
        ],
        "notIn": [
          "REQUESTED"
        ]
      },
      "blockchain": {
        "eq": "AVALANCHE",
        "notEq": "AVALANCHE",
        "in": [
          "AVALANCHE"
        ],
        "notIn": [
          "AVALANCHE"
        ]
      },
      "assetSymbol": {
        "eq": "string",
        "notEq": "string",
        "contains": "string",
        "startsWith": "string",
        "endsWith": "string",
        "in": [
          "string"
        ],
        "notIn": [
          "string"
        ],
        "isNull": true
      },
      "createdAt": {
        "eq": "2024-08-08T10:00:00Z",
        "notEq": "2024-08-08T10:00:00Z",
        "before": "2024-08-08T10:00:00Z",
        "after": "2024-08-08T10:00:00Z",
        "gte": "2024-08-08T10:00:00Z",
        "lte": "2024-08-08T10:00:00Z",
        "between": {
          "start": "2024-08-01T00:00:00Z",
          "end": "2024-08-31T23:59:59Z"
        },
        "isNull": true,
        "relativeDays": -7
      },
      "qty": {
        "eq": "string",
        "notEq": "string",
        "in": [
          "string"
        ],
        "notIn": [
          "string"
        ],
        "isNull": true,
        "gt": "string",
        "gte": "string",
        "lt": "string",
        "lte": "string"
      },
      "originAddress": {
        "eq": "string",
        "notEq": "string",
        "contains": "string",
        "startsWith": "string",
        "endsWith": "string",
        "in": [
          "string"
        ],
        "notIn": [
          "string"
        ],
        "isNull": true
      },
      "destinationAddress": {
        "eq": "string",
        "notEq": "string",
        "contains": "string",
        "startsWith": "string",
        "endsWith": "string",
        "in": [
          "string"
        ],
        "notIn": [
          "string"
        ],
        "isNull": true
      },
      "transactionId": {
        "eq": "string",
        "notEq": "string",
        "contains": "string",
        "startsWith": "string",
        "endsWith": "string",
        "in": [
          "string"
        ],
        "notIn": [
          "string"
        ],
        "isNull": true
      },
      "transactionHash": {
        "eq": "string",
        "notEq": "string",
        "contains": "string",
        "startsWith": "string",
        "endsWith": "string",
        "in": [
          "string"
        ],
        "notIn": [
          "string"
        ],
        "isNull": true
      },
      "externalId": {
        "eq": "string",
        "notEq": "string",
        "contains": "string",
        "startsWith": "string",
        "endsWith": "string",
        "in": [
          "string"
        ],
        "notIn": [
          "string"
        ],
        "isNull": true
      },
      "updatedAt": {
        "eq": "2024-08-08T10:00:00Z",
        "notEq": "2024-08-08T10:00:00Z",
        "before": "2024-08-08T10:00:00Z",
        "after": "2024-08-08T10:00:00Z",
        "gte": "2024-08-08T10:00:00Z",
        "lte": "2024-08-08T10:00:00Z",
        "between": {
          "start": "2024-08-01T00:00:00Z",
          "end": "2024-08-31T23:59:59Z"
        },
        "isNull": true,
        "relativeDays": -7
      },
      "correlationId": {
        "eq": "string",
        "notEq": "string",
        "contains": "string",
        "startsWith": "string",
        "endsWith": "string",
        "in": [
          "string"
        ],
        "notIn": [
          "string"
        ],
        "isNull": true
      },
      "type": {
        "eq": "DEPOSIT",
        "notEq": "DEPOSIT",
        "in": [
          "DEPOSIT"
        ],
        "notIn": [
          "DEPOSIT"
        ]
      },
      "origin": {
        "eq": "string",
        "notEq": "string",
        "contains": "string",
        "startsWith": "string",
        "endsWith": "string",
        "in": [
          "string"
        ],
        "notIn": [
          "string"
        ],
        "isNull": true
      },
      "destination": {
        "eq": "string",
        "notEq": "string",
        "contains": "string",
        "startsWith": "string",
        "endsWith": "string",
        "in": [
          "string"
        ],
        "notIn": [
          "string"
        ],
        "isNull": true
      }
    },
    "pagination": {
      "pageSize": 50,
      "pageToken": "cGFnZV9zaXplPTEwJnBhZ2VfdG9rZW49MjA=",
      "orderBy": "created_at",
      "order": "SORT_ORDER_ASC"
    },
    "search": "0x55502b9d5a68b0F8a48384352295BeD968aD8AA4"
  }'

Responses

A successful response.

Bodyapplication/json
filterobject(v2FilterResponse)
transactionsArray of objects(transactionsv2Transaction)
Response
{
  "filter": {
    "previousPageToken": "cGFnZV9zaXplPTEwJnBhZ2VfdG9rZW49MjA=",
    "nextPageToken": "cGFnZV9zaXplPTEwJnBhZ2VfdG9rZW49MjA=",
    "total": 100
  },
  "transactions": [
    { … }
  ]
}