List Transactions

Returns all transactions accessible to the authenticated API user(business).

Endpoint Details

Method: GET
Path: /api/transaction
Authentication: Required (API Key)

Request

GET /api/transaction
Authorization: Bearer <your_api_key>
Accept: application/json

Query Parameters (APIPagingDto)

All query parameters are optional and can be used to filter, sort, and paginate the results:

Parameter	Type	Description
`limit`	integer	Maximum number of items to return
`sort`	string	Field to sort by
`direction`	string	Sort direction (asc/desc)
`select`	array	Array of specific fields to return
`filter`	string	Filter expression for results
`math`	string	Mathematical operations on results
`range`	string	Range-based filtering
`page`	integer	Page number for pagination
`cursor`	string	Cursor-based pagination identifier
`logic`	string	Logical operations for complex queries

Example Request

GET /api/transaction?limit=10&page=1&sort=created_at&direction=desc
Authorization: Bearer <your_api_key>
Accept: application/json

Response

Success Response (200)

{
  "message": "transactions successfully fetched",
    "status": "success",
    "data": {
    "transactions": [
      {
        "id": "uuid",
        "business_id": "uuid",
        "hash_url": "string",
        "reference": "string",
        "transaction_type": "string",
        "status": "string",
        "mode": "string",
        "channel": "string",
        "source": "string",
        "destination": "string",
        "narration": "string",

        "from_address": "string",
        "from_amount": "string",
        "from_currency": "string",
        "from_network": "string",
        "from_currency_has_minor": false,

        "to_address": "string",
        "to_amount": "string",
        "to_currency": "string",
        "to_network": "string",
        "to_currency_has_minor": false,

        "fee": 0,
        "fee_currency": "string",
        "fee_currency_has_minor": false,

        "business_id": "uuid",
        "destination": null,

        "created_at": "2023-10-27T10:30:00Z",
        "updated_at": "2023-10-27T10:30:00Z"
      }
    ],
    "paging": {
      "totalCount": 10,
      "page": 1,
      "hasNextPage": true,
      "next_cursor": "cursor_string",
      "previous_cursor": "cursor_string"
    }
  }
}

{
    "message": "transactions successfully fetched",
    "status": "success",
    "data": {
        "transactions": [
            {
                "id": "7e521ac2-9d2c-4078-8a7a-32c67a073042",
                "business_id": "33c248f4-8644-40f5-9c4a-e2e17426a709",
                "source": "crypto-wallet",
                "destination": "crypto-wallet",
                "reference": "VACWF2510030822377VY6Q011",
                "mode": "credit",
                "transaction_type": "Wallet Funding",
                "status": "success",
                "from_amount": "10",
                "from_currency": "USDC",
                "from_currency_has_minor": false,
                "from_network": "ERC20",
                "to_amount": "10",
                "to_currency": "USDC",
                "to_currency_has_minor": false,
                "to_network": "ERC20",
                "narration": "Wallet Funding From External to Olawale",
                "created_at": "2025-10-03T08:22:37.167937Z",
                "updated_at": "2025-10-03T08:22:37.167937Z",
                "completed_at": "2025-10-03T08:22:37.167936Z",
                "from_address": "0x3C3380cdFb94dFEEaA41cAD9F58254AE380d752D",
                "to_address": "0x6BECC92E4c75F833D4036545dD4Aa84aaF8583ec",
                "hash_url": "https://sepolia.etherscan.io/tx/0x1309904d45312..."
            }
        ],
        "pageInfo": {
            "totalCount": 1,
            "page": 1,
            "hasNextPage": false,
            "next_cursor": "",
            "previous_cursor": ""
        }
    }
}

Error Responses

Status Code	Description
400	Invalid input or malformed query parameters
401	Unauthorized - Invalid or missing API key
500	Internal server error

Data Models

Transaction Object

Field	Type	Description
`id`	uuid	Unique transaction identifier
`business_id`	string	Owning business identifier
`source`	string	Transaction source
`destination`	string	Transaction destination
`reference`	object	System reference for reconciliation
`mode`	string	Processing mode - credit or debit
transaction_type	string	Transaction type
status	string	Current status of the transaction
from_amount	float64	Source amount
from_currency	string	Asset type (e.g., USDT, USDC)
from_currency_has_minor	bool	Whether source currency has a minor unit
from_network	string	Blockchain network (e.g., ERC20, TRC20)
to_amount	float64	Destination amount
to_currency	string	Asset type (e.g., USDT, USDC)
to_currency_has_minor	bool	Whether destination currency has a minor unit
to_network	string	Blockchain network (e.g., ERC20, TRC20)
fee	float64	Total fee
fee_currency	string	Asset type (e.g., USDT, USDC)
fee_currency_has_minor	bool	Whether fee currency has a minor unit
narration	string	Narration of the transaction; may be omitted
failure_reason	string	Failure reason if applicable; may be omitted
from_address	string	Sender wallet address; may be omitted
to_address	string	Recipient wallet address; may be omitted
hash_url	string	Hash URL on the blockchain; may be omitted
history	object	Change history entries for this transaction
`created_at`	timestamp	ISO-8601 formatted creation timestamp
`updated_at`	timestamp	ISO-8601 formatted last update timestamp; may be omitted
`completed_at`	timestamp	ISO-8601 formatted last completed timestamp; may be omitted

Change History Object

Field	Type	Description
`id`	uuid	ID of the change history object
`business_id`	uuid	ID of the business
`object_ref`	string	object name
`object_id`	uuid	id of the object
`comment`	string	[Optional] comment(s)
`status`	string	status of the history data
`submitted_by`	string	user who committed the change
`created_at`	timestamp	time at which the change was committed

Pagination Info

Field	Type	Description
`totalCount`	int64	Total number of wallets available
`page`	integer	Current page number
`hasNextPage`	boolean	Whether there are more pages available
`next_cursor`	string	Cursor for retrieving the next page
`previous_cursor`	string	Cursor for retrieving the previous page

Usage Examples

Basic Request

curl -X GET "https://ba-be-stg.usevaulta.com/v1/api/transaction" \
  -H "Authorization: Bearer your_api_key" \
  -H "Accept: application/json"

Filtered Request

curl -X GET "https://ba-be-stg.usevaulta.com/v1/api/transaction?filter=from_currency:USDT&limit=7" \
  -H "Authorization: Bearer your_api_key" \
  -H "Accept: application/json"

Paginated Request

curl -X GET "https://ba-be-stg.usevaulta.com/v1/api/transaction?page=2&limit=10" \
  -H "Authorization: Bearer your_api_key" \
  -H "Accept: application/json"