---
title: "Get all transactions for an agent"
method: POST
path: "/v0.2.4/agents/transactions"
tags: ["Agents"]
---

# Get all transactions for an agent

`POST /v0.2.4/agents/transactions`

Retrieve all transactions performed by a specific agent (agent owner only)

## Query parameters

- `agentId` string, required
- `subAccount` string

## Request body

- object
  - `page` number — Page number for pagination
  - `limit` number — Number of transactions per page
  - `filters` object — Transaction filters
    - `startDate` string, date — Start date for filtering
    - `endDate` string, date — End date for filtering
    - `status` string — Transaction status
    - `currency` string — Currency code (USD, CAD, NGN, etc.)

## Response `200`

Transactions retrieved successfully

- object
  - `status` string
  - `message` string
  - `data` object[]
  - `totalCount` number
  - `meta` object
    - `agentId` string
    - `page` number
    - `limit` number
  - `balances` object — Period balances (if date filters provided)

## Other responses

- `400` — Validation error in the request.
- `401` — Access to this resource is not available for unauthenticated users.
- `403` — Access to this resource is forbidden.
- `500` — Indicates an internal server error.

---

[API](https://skmtc.net/chimoney/apis/chimoney-api-docs.md) · [All operations](https://skmtc.net/chimoney/apis/chimoney-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chimoney/chimoney-api-docs/revisions/227751df36a0/schema)