Skip to content
/
Submit client-side signed...

PERS-api Documentation (2.2.2)

PERS API Documentation

This RESTful API enables seamless integration of Web3 loyalty, token management, and engagement features into your applications.

Usage Guidelines:

  • RESTful Design: Resources are accessed via standard HTTP methods (GET, POST, PUT, DELETE) with predictable, resource-oriented URLs.
  • Authentication: Secure access is enforced via Bearer Tokens (JWT) and Project Keys (defining the Tenant context).
  • Data Format: All requests and responses utilize standard JSON formatting.

Explore the modules below for detailed endpoint specifications, schemas, and testing capabilities.

Download OpenAPI description
swagger.json
swagger.yaml
Overview
Languages
Servers
Mock server
https://docs.pers.ninja/_mock/swagger
https://api.pers.ninja/v2

Tenants

Operations

Admins

Operations

Tokens

Operations

Campaigns

Operations

Campaign Tags

Operations

Campaign Tokens

Operations

Campaign Triggers

Operations

Campaign Engagements

Operations

Campaign Claims

Operations

Redemptions

Operations

Purchases

Operations

Businesses

Operations

Transactions

Operations

Transaction Management System

Comprehensive transaction management for credits and tokens with secure processing and real-time balance updates. Handles all operations within the loyalty platform.
Transaction Operations:

•
Token Minting:
Create new tokens and add to user accounts

•
Token Transfers:
Secure peer-to-peer token transfers between users

•
Token Burning:
Remove tokens from circulation with proper audit trails

•
Balance Queries:
Real-time balance checks across multiple token types

•
Transaction Authorization:
Verify user permissions and sufficient balances

•
Transaction History:
Complete audit logs for all operations

Get current user/business transactions

Request

Consolidated endpoint for user/business transactions. Use role parameter to filter: SENDER (sent), RECIPIENT (received), or omit for all transactions. Use include parameter to enrich with full entity data. 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

participantAddressstring

Filter by specific wallet address (must belong to authentication context for non-admins)

tokenAddressstring
engagedBusinessIdstring

Filter by engaged business ID (for campaign claim transactions)

pagenumber

Page number (1-based)

limitnumber

Items per page

sortBystring

Sort field

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""broadcasted""succeeded""failed""cancelled""expired"
roleArray of strings

Filter by transaction role: SENDER, RECIPIENT, or omit for all

Items Enum"SENDER""RECIPIENT"
curl -i -X GET \
  'https://docs.pers.ninja/_mock/swagger/transactions/me?include=string&search=string&participantAddress=string&tokenAddress=string&engagedBusinessId=string&page=0&limit=0&sortBy=string&sortOrder=ASC&dateFrom=string&dateTo=string&type=MINT&status=created&role=SENDER' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

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

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""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=string&sortOrder=ASC&dateFrom=string&dateTo=string&type=MINT&status=created&role=SENDER' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Create transaction

Request

Create any type of transaction (MINT/TRANSFER/BURN) using role-based trigger detection. Sender will be determined based on the authentication context or provided explicitly (Pending verification). Depending on transaction type and signing context will either return a prepared transaction for client-side signing or execute server-side directly.

Security
authJWT
Bodyapplication/jsonrequired
web3TransactionTypestringrequired

Transaction type for easier detection and routing

Enum"MINT""TRANSFER""BURN"
Example: "TRANSFER"
senderobject

Transaction sender, will be resolved from auth context if not provided. if provided and different from auth user, signing capabilities will be checked or transaction will be rejected.

recipientobject

Transaction recipient (not required for BURN operations)

tokenobject

Token identification with multiple resolution strategies. If not provided, defaults to active credit token.

amountnumberrequired

Transaction amount

Example: 100
engagedBusinessIdstring

Business commercially involved in this transaction (for stats/reporting). Used for POS scenarios.

Example: "business-uuid-123"
authorizedSubmitterIdstring

Entity authorized to submit this transaction. For POS flow, this is typically the business. Defaults to sender if not provided.

Example: "entity-uuid-456"
authorizedSubmitterTypestring

Type of entity authorized to submit (USER, BUSINESS). Defaults to USER if not provided.

Enum"user""business""tenant""system""external"
Example: "business"
curl -i -X POST \
  https://docs.pers.ninja/_mock/swagger/transactions \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "web3TransactionType": "TRANSFER",
    "sender": {
      "accountId": "user123",
      "accountType": "user",
      "accountAddress": "0x742d35Cc5dB3dC0F0e8f0b0d2fA0c3fA2ed5D0f8"
    },
    "recipient": {
      "accountId": "user123",
      "accountType": "user",
      "accountAddress": "0x742d35Cc5dB3dC0F0e8f0b0d2fA0c3fA2ed5D0f8"
    },
    "token": {
      "tokenDbId": "uuid-12345-67890",
      "contractAddress": "0x742d35Cc5dB3dC0F0e8f0b0d2fA0c3fA2ed5D0f8",
      "contractTokenId": "721",
      "chainId": 1
    },
    "amount": 100,
    "engagedBusinessId": "business-uuid-123",
    "authorizedSubmitterId": "entity-uuid-456",
    "authorizedSubmitterType": "business"
  }'

Responses

transaction created

Bodyapplication/json
transactionobjectrequired

Transaction details

transaction.​amountobjectrequired

Transaction amount

transaction.​idstringrequired

Transaction id

transaction.​tokenAddressstringrequired

Transaction token address

transaction.​contractTokenIdobject or nullrequired

Transaction token contract id, this is the blockchain contract id of the token

transaction.​tokenTypeobjectrequired

Transaction token type

transaction.​senderAddressstringrequired

Sender address

transaction.​recipientAddressobjectrequired

Recipient address

transaction.​transactionHashobjectrequired

Transaction hash

transaction.​typestringrequired

Transaction type

Enum"MINT""TRANSFER""BURN"
transaction.​triggerProcessTypestringrequired

Trigger process type

Enum"PURCHASE""SPEND""TRANSFER""EARN""CAMPAIGN_USER_CLAIM""CAMPAIGN_SYSTEM_CLAIM""CAMPAIGN_BUSINESS_CLAIM""REDEMPTION_SPEND""REDEMPTION_RECEIVE""MIGRATION"
transaction.​triggerProcessIdobjectrequired

Trigger process id, this is the id of the entity that triggered the transaction if applicable (e.g. CampaignUserClaim id)

transaction.​statusstringrequired

Transaction status

Enum"created""processing""pending_signature""broadcasted""succeeded""failed""cancelled""expired"
transaction.​createdAtobjectrequired

create date

transaction.​updatedAtobjectrequired

update date

transaction.​tenantIdstringrequired

Tenant ID for multi-tenant isolation

transaction.​chainIdobjectrequired

Blockchain chain ID

transaction.​senderIdobject or nullrequired

Sender entity ID (polymorphic reference)

transaction.​senderOwnerTypestring or nullrequired

Sender entity type (user, business, system etc.)

Enum"user""business""tenant""system""external"
transaction.​recipientIdobject or nullrequired

Recipient entity ID (polymorphic reference)

transaction.​recipientOwnerTypestring or nullrequired

Recipient entity type (user, Business, system, etc.)

Enum"user""business""tenant""system""external"
transaction.​messageobject or nullrequired

Optional message associated with the transaction, e.g. for error details

transaction.​engagedBusinessIdobject or nullrequired

Business commercially involved in this transaction (for stats/reporting)

transaction.​authorizedSubmitterIdobject or nullrequired

Entity authorized to submit this transaction (for POS flow security)

transaction.​authorizedSubmitterTypestring or nullrequired

Type of entity authorized to submit (USER, BUSINESS, etc.)

Enum"user""business""tenant""system""external"
transaction.​includedobject or null

Included related entities. Only populated when include parameter is specified. Contains sender, recipient, and/or engaged business entities based on requested relations.

transactionStatusstringrequired

Current status of the transaction

Enum"created""processing""pending_signature""broadcasted""succeeded""failed""cancelled""expired"
signingDataobject or nullrequired

Prepared transaction data ready for signing (if applicable)

actionableobject or nullrequired

Actionable details for the transaction, if applicable

actionable.​messageobject

User-friendly message describing the action

actionable.​actionUrlobject

URL to perform the action

actionable.​authTokenobject

Authentication token for the action

actionable.​actionTypestringrequired

Type of action to be performed

walletSigningStatusstringrequired

Current status of the wallet signing process

Response
application/json
{
  "transaction": {
    "amount": {},
    "id": "string",
    "tokenAddress": "string",
    "contractTokenId": {},
    "tokenType": {},
    "senderAddress": "string",
    "recipientAddress": {},
    "transactionHash": {},
    "type": "MINT",
    "triggerProcessType": "PURCHASE",
    "triggerProcessId": {},
    "status": "created",
    "createdAt": {},
    "updatedAt": {},
    "tenantId": "string",
    "chainId": {},
    "senderId": {},
    "senderOwnerType": "user",
    "recipientId": {},
    "recipientOwnerType": "user",
    "message": {},
    "engagedBusinessId": {},
    "authorizedSubmitterId": {},
    "authorizedSubmitterType": "user",
    "included": { … }
  },
  "transactionStatus": "created",
  "signingData": {},
  "actionable": {
    "message": {},
    "actionUrl": {},
    "authToken": {},
    "actionType": "string"
  },
  "walletSigningStatus": "string"
}

Get transaction by ID

Request

Get single transaction by ID with optional entity inclusion. Use include parameter to enrich with full entity data. Requires valid project API key.

Security
authJWT
Path
idstringrequired
Query
includeArray of strings

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

curl -i -X GET \
  'https://docs.pers.ninja/_mock/swagger/transactions/{id}?include=string' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Transaction found

Bodyapplication/json
amountobjectrequired

Transaction amount

idstringrequired

Transaction id

tokenAddressstringrequired

Transaction token address

contractTokenIdobject or nullrequired

Transaction token contract id, this is the blockchain contract id of the token

tokenTypeobjectrequired

Transaction token type

senderAddressstringrequired

Sender address

recipientAddressobjectrequired

Recipient address

transactionHashobjectrequired

Transaction hash

typestringrequired

Transaction type

Enum"MINT""TRANSFER""BURN"
triggerProcessTypestringrequired

Trigger process type

Enum"PURCHASE""SPEND""TRANSFER""EARN""CAMPAIGN_USER_CLAIM""CAMPAIGN_SYSTEM_CLAIM""CAMPAIGN_BUSINESS_CLAIM""REDEMPTION_SPEND""REDEMPTION_RECEIVE""MIGRATION"
triggerProcessIdobjectrequired

Trigger process id, this is the id of the entity that triggered the transaction if applicable (e.g. CampaignUserClaim id)

statusstringrequired

Transaction status

Enum"created""processing""pending_signature""broadcasted""succeeded""failed""cancelled""expired"
createdAtobjectrequired

create date

updatedAtobjectrequired

update date

tenantIdstringrequired

Tenant ID for multi-tenant isolation

chainIdobjectrequired

Blockchain chain ID

senderIdobject or nullrequired

Sender entity ID (polymorphic reference)

senderOwnerTypestring or nullrequired

Sender entity type (user, business, system etc.)

Enum"user""business""tenant""system""external"
recipientIdobject or nullrequired

Recipient entity ID (polymorphic reference)

recipientOwnerTypestring or nullrequired

Recipient entity type (user, Business, system, etc.)

Enum"user""business""tenant""system""external"
messageobject or nullrequired

Optional message associated with the transaction, e.g. for error details

engagedBusinessIdobject or nullrequired

Business commercially involved in this transaction (for stats/reporting)

authorizedSubmitterIdobject or nullrequired

Entity authorized to submit this transaction (for POS flow security)

authorizedSubmitterTypestring or nullrequired

Type of entity authorized to submit (USER, BUSINESS, etc.)

Enum"user""business""tenant""system""external"
includedobject or null

Included related entities. Only populated when include parameter is specified. Contains sender, recipient, and/or engaged business entities based on requested relations.

Response
application/json
{
  "amount": {},
  "id": "string",
  "tokenAddress": "string",
  "contractTokenId": {},
  "tokenType": {},
  "senderAddress": "string",
  "recipientAddress": {},
  "transactionHash": {},
  "type": "MINT",
  "triggerProcessType": "PURCHASE",
  "triggerProcessId": {},
  "status": "created",
  "createdAt": {},
  "updatedAt": {},
  "tenantId": "string",
  "chainId": {},
  "senderId": {},
  "senderOwnerType": "user",
  "recipientId": {},
  "recipientOwnerType": "user",
  "message": {},
  "engagedBusinessId": {},
  "authorizedSubmitterId": {},
  "authorizedSubmitterType": "user",
  "included": {
    "sender": { … },
    "recipient": { … },
    "engagedBusiness": { … }
  }
}

Prepare existing transaction for client-side signing

Request

Prepares transaction data for client-side execution from existing transaction ID. Returns the data needed for the client to sign and submit the transaction.

Security
authJWT
Path
idstringrequired
curl -i -X GET \
  'https://docs.pers.ninja/_mock/swagger/transactions/{id}/prepare' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Transaction prepared successfully

Bodyapplication/json
transactionobjectrequired

Transaction details

transaction.​amountobjectrequired

Transaction amount

transaction.​idstringrequired

Transaction id

transaction.​tokenAddressstringrequired

Transaction token address

transaction.​contractTokenIdobject or nullrequired

Transaction token contract id, this is the blockchain contract id of the token

transaction.​tokenTypeobjectrequired

Transaction token type

transaction.​senderAddressstringrequired

Sender address

transaction.​recipientAddressobjectrequired

Recipient address

transaction.​transactionHashobjectrequired

Transaction hash

transaction.​typestringrequired

Transaction type

Enum"MINT""TRANSFER""BURN"
transaction.​triggerProcessTypestringrequired

Trigger process type

Enum"PURCHASE""SPEND""TRANSFER""EARN""CAMPAIGN_USER_CLAIM""CAMPAIGN_SYSTEM_CLAIM""CAMPAIGN_BUSINESS_CLAIM""REDEMPTION_SPEND""REDEMPTION_RECEIVE""MIGRATION"
transaction.​triggerProcessIdobjectrequired

Trigger process id, this is the id of the entity that triggered the transaction if applicable (e.g. CampaignUserClaim id)

transaction.​statusstringrequired

Transaction status

Enum"created""processing""pending_signature""broadcasted""succeeded""failed""cancelled""expired"
transaction.​createdAtobjectrequired

create date

transaction.​updatedAtobjectrequired

update date

transaction.​tenantIdstringrequired

Tenant ID for multi-tenant isolation

transaction.​chainIdobjectrequired

Blockchain chain ID

transaction.​senderIdobject or nullrequired

Sender entity ID (polymorphic reference)

transaction.​senderOwnerTypestring or nullrequired

Sender entity type (user, business, system etc.)

Enum"user""business""tenant""system""external"
transaction.​recipientIdobject or nullrequired

Recipient entity ID (polymorphic reference)

transaction.​recipientOwnerTypestring or nullrequired

Recipient entity type (user, Business, system, etc.)

Enum"user""business""tenant""system""external"
transaction.​messageobject or nullrequired

Optional message associated with the transaction, e.g. for error details

transaction.​engagedBusinessIdobject or nullrequired

Business commercially involved in this transaction (for stats/reporting)

transaction.​authorizedSubmitterIdobject or nullrequired

Entity authorized to submit this transaction (for POS flow security)

transaction.​authorizedSubmitterTypestring or nullrequired

Type of entity authorized to submit (USER, BUSINESS, etc.)

Enum"user""business""tenant""system""external"
transaction.​includedobject or null

Included related entities. Only populated when include parameter is specified. Contains sender, recipient, and/or engaged business entities based on requested relations.

transactionStatusstringrequired

Current status of the transaction

Enum"created""processing""pending_signature""broadcasted""succeeded""failed""cancelled""expired"
signingDataobject or nullrequired

Prepared transaction data ready for signing (if applicable)

actionableobject or nullrequired

Actionable details for the transaction, if applicable

actionable.​messageobject

User-friendly message describing the action

actionable.​actionUrlobject

URL to perform the action

actionable.​authTokenobject

Authentication token for the action

actionable.​actionTypestringrequired

Type of action to be performed

walletSigningStatusstringrequired

Current status of the wallet signing process

Response
application/json
{
  "transaction": {
    "amount": {},
    "id": "string",
    "tokenAddress": "string",
    "contractTokenId": {},
    "tokenType": {},
    "senderAddress": "string",
    "recipientAddress": {},
    "transactionHash": {},
    "type": "MINT",
    "triggerProcessType": "PURCHASE",
    "triggerProcessId": {},
    "status": "created",
    "createdAt": {},
    "updatedAt": {},
    "tenantId": "string",
    "chainId": {},
    "senderId": {},
    "senderOwnerType": "user",
    "recipientId": {},
    "recipientOwnerType": "user",
    "message": {},
    "engagedBusinessId": {},
    "authorizedSubmitterId": {},
    "authorizedSubmitterType": "user",
    "included": { … }
  },
  "transactionStatus": "created",
  "signingData": {},
  "actionable": {
    "message": {},
    "actionUrl": {},
    "authToken": {},
    "actionType": "string"
  },
  "walletSigningStatus": "string"
}

Submit client-side signed transaction

Request

Submits a signed transaction from the client. This method is used to finalize the transaction after the client has signed it.

Security
authJWT
Bodyapplication/jsonrequired
transactionIdstringrequired

Transaction ID, this is the transaction hash or identifier

typestringrequired

Transaction format type for submission

Enum"legacy""EIP-2930""EIP-1559""EIP-712"
Example: "legacy"
signaturestring

EIP-712 structured data for smart wallet meta-transactions (required when type is EIP-712)

Example: "0x1234567890abcdef..."
signedTransactionstring

Pre-signed blockchain transaction in RLP encoded hex format (required for legacy, EIP-2930, EIP-1559)

Example: "0xf86c0a8255f0..."
curl -i -X POST \
  https://docs.pers.ninja/_mock/swagger/transactions/submit \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "transactionId": "string",
    "type": "legacy",
    "signature": "0x1234567890abcdef...",
    "signedTransaction": "0xf86c0a8255f0..."
  }'

Responses

Transaction submitted successfully

Bodyapplication/json
transactionobjectrequired

Transaction details

transaction.​amountobjectrequired

Transaction amount

transaction.​idstringrequired

Transaction id

transaction.​tokenAddressstringrequired

Transaction token address

transaction.​contractTokenIdobject or nullrequired

Transaction token contract id, this is the blockchain contract id of the token

transaction.​tokenTypeobjectrequired

Transaction token type

transaction.​senderAddressstringrequired

Sender address

transaction.​recipientAddressobjectrequired

Recipient address

transaction.​transactionHashobjectrequired

Transaction hash

transaction.​typestringrequired

Transaction type

Enum"MINT""TRANSFER""BURN"
transaction.​triggerProcessTypestringrequired

Trigger process type

Enum"PURCHASE""SPEND""TRANSFER""EARN""CAMPAIGN_USER_CLAIM""CAMPAIGN_SYSTEM_CLAIM""CAMPAIGN_BUSINESS_CLAIM""REDEMPTION_SPEND""REDEMPTION_RECEIVE""MIGRATION"
transaction.​triggerProcessIdobjectrequired

Trigger process id, this is the id of the entity that triggered the transaction if applicable (e.g. CampaignUserClaim id)

transaction.​statusstringrequired

Transaction status

Enum"created""processing""pending_signature""broadcasted""succeeded""failed""cancelled""expired"
transaction.​createdAtobjectrequired

create date

transaction.​updatedAtobjectrequired

update date

transaction.​tenantIdstringrequired

Tenant ID for multi-tenant isolation

transaction.​chainIdobjectrequired

Blockchain chain ID

transaction.​senderIdobject or nullrequired

Sender entity ID (polymorphic reference)

transaction.​senderOwnerTypestring or nullrequired

Sender entity type (user, business, system etc.)

Enum"user""business""tenant""system""external"
transaction.​recipientIdobject or nullrequired

Recipient entity ID (polymorphic reference)

transaction.​recipientOwnerTypestring or nullrequired

Recipient entity type (user, Business, system, etc.)

Enum"user""business""tenant""system""external"
transaction.​messageobject or nullrequired

Optional message associated with the transaction, e.g. for error details

transaction.​engagedBusinessIdobject or nullrequired

Business commercially involved in this transaction (for stats/reporting)

transaction.​authorizedSubmitterIdobject or nullrequired

Entity authorized to submit this transaction (for POS flow security)

transaction.​authorizedSubmitterTypestring or nullrequired

Type of entity authorized to submit (USER, BUSINESS, etc.)

Enum"user""business""tenant""system""external"
transaction.​includedobject or null

Included related entities. Only populated when include parameter is specified. Contains sender, recipient, and/or engaged business entities based on requested relations.

transactionStatusstringrequired

Current status of the transaction

Enum"created""processing""pending_signature""broadcasted""succeeded""failed""cancelled""expired"
signingDataobject or nullrequired

Prepared transaction data ready for signing (if applicable)

actionableobject or nullrequired

Actionable details for the transaction, if applicable

actionable.​messageobject

User-friendly message describing the action

actionable.​actionUrlobject

URL to perform the action

actionable.​authTokenobject

Authentication token for the action

actionable.​actionTypestringrequired

Type of action to be performed

walletSigningStatusstringrequired

Current status of the wallet signing process

Response
application/json
{
  "transaction": {
    "amount": {},
    "id": "string",
    "tokenAddress": "string",
    "contractTokenId": {},
    "tokenType": {},
    "senderAddress": "string",
    "recipientAddress": {},
    "transactionHash": {},
    "type": "MINT",
    "triggerProcessType": "PURCHASE",
    "triggerProcessId": {},
    "status": "created",
    "createdAt": {},
    "updatedAt": {},
    "tenantId": "string",
    "chainId": {},
    "senderId": {},
    "senderOwnerType": "user",
    "recipientId": {},
    "recipientOwnerType": "user",
    "message": {},
    "engagedBusinessId": {},
    "authorizedSubmitterId": {},
    "authorizedSubmitterType": "user",
    "included": { … }
  },
  "transactionStatus": "created",
  "signingData": {},
  "actionable": {
    "message": {},
    "actionUrl": {},
    "authToken": {},
    "actionType": "string"
  },
  "walletSigningStatus": "string"
}

Export all transactions as CSV

Request

Downloads all transactions as a CSV file. RLS ensures tenant isolation automatically. File includes all transaction data formatted for business analysis.

Security
authJWT
curl -i -X GET \
  https://docs.pers.ninja/_mock/swagger/transactions/export/csv \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

CSV file download

Headers
Content-Typestring

MIME type of the file

Example: "text/csv"
Content-Dispositionstring

File download attachment

Example: "attachment; filename=\"transactions_2024-01-15.csv\""
Bodyapplication/json
string(binary)
Response
application/json
"string"

Users

Operations

Balances

Operations

Files

Operations

Web3 Chains

Operations

Contracts

Operations

Auth

Operations

Root

Operations

Well-known

Operations

Trigger Sources

Operations

Business Types

Operations

Redemption Types

Operations

Redemption Redeems

Operations

Redemption Tokens

Operations

API Keys

Operations