API Reference

Get wallet transactions

get

Retrieve wallet transactions with optional filters for status, date range, and pagination

Authorizations

ApiKeyAuth

x-api-keystringRequired

API key for authentication. Get your API key from the KiraPay dashboard.

Query parameters

statusstring · enumOptional

Filter by transaction status

Possible values:

transaction_hashstringOptional

Filter by transaction hash

from_datestring · date-timeOptional

Filter transactions from this date (ISO 8601 format)

Example: 2024-01-01T00:00:00Z

to_datestring · date-timeOptional

Filter transactions up to this date (ISO 8601 format)

Example: 2024-12-31T23:59:59Z

pageinteger · min: 1Optional

Page number for pagination

Default: 1

limitinteger · min: 1 · max: 100Optional

Number of items per page

Default: 10

Responses

200

Transactions retrieved successfully

application/json

401

Unauthorized - Invalid or missing API key

application/json

500

Internal server error

application/json

get

/wallet/transactions

HTTPcURLJavaScriptPython

GET /api/wallet/transactions HTTP/1.1
Host: kirapay-api.holatech.app
x-api-key: YOUR_API_KEY
Accept: */*

{
  "message": "Transactions retrieved successfully",
  "data": {
    "transactions": [
      {
        "_id": "507f1f77bcf86cd799439013",
        "transaction_hash": "0xabc123...",
        "status": "COMPLETED",
        "amount": 100,
        "token": "USDC",
        "from": "0x1234567890abcdef1234567890abcdef12345678",
        "to": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
        "createdAt": "2024-01-15T10:30:00Z"
      }
    ],
    "total": 50,
    "page": 1,
    "totalPages": 5
  }
}