Skip to content

Get all transactions with advanced filtering

Request

Get transactions with comprehensive filtering options:

  • include: Enrich with full entity data (sender, recipient, business)
  • search: Wildcard search for ID, address or transaction hash
  • participantId: Filter by user/business/tenant ID
  • role: Filter by SENDER, RECIPIENT, or both (omit for all)
  • status: Filter by transaction status
  • tokenType: Filter by token type
  • type: Filter by transaction type (MINT, BURN, TRANSFER)
  • Always returns PaginatedResponseDTO
Security
authJWT
Query
includeArray of strings

Optional relations to enrich: sender (User/Business), recipient (User/Business), business (engaged Business). Omit for fast response with IDs only.

searchstring

Wildcard search for ID, address or transaction hash

participantIdstring
participantAddressstring
tokenAddressstring
engagedBusinessIdstring

Filter by engaged business ID (for campaign claim transactions)

pagenumber

Page number (1-based)

limitnumber

Items per page

sortBystring

Sort field

Enum:"createdAt""amount""type""tokenType""status""senderAddress""recipientAddress"
sortOrderstring

Sort order

Enum:"ASC""DESC"
dateFromstring

Filter items created after this date (ISO 8601)

dateTostring

Filter items created before this date (ISO 8601)

typeArray of strings
Items Enum:"MINT""TRANSFER""BURN"
tokenTypeArray of any
statusArray of strings
Items Enum:"created""processing""pending_signature""pending_submission""broadcasted""succeeded""failed""cancelled""expired"
roleArray of strings
Items Enum:"SENDER""RECIPIENT"
curl -i -X GET \
  'https://docs.pers.ninja/_mock/swagger/transactions?include=string&search=string&participantId=string&participantAddress=string&tokenAddress=string&engagedBusinessId=string&page=0&limit=0&sortBy=createdAt&sortOrder=ASC&dateFrom=string&dateTo=string&type=MINT&tokenType=&status=created&role=SENDER' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses