---
title: "List a card account's transactions."
method: GET
path: "/ledger/card-accounts/{cardAccountId}/transactions"
tags: ["ledger-card accounts"]
---

# List a card account's transactions.

`GET /ledger/card-accounts/{cardAccountId}/transactions`

## Request

- Base URL: `https://external.dev.onboardpay.co`
- URL: `https://external.dev.onboardpay.co/ledger/card-accounts/{cardAccountId}/transactions`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/nestechops/apis/onboard-external-api-gateway/docs/ledger/card-accounts/:cardAccountId/transactions/get.ts> (a function with typed inputs; its response is checked against the schema)

Pass-through of the card provider's transaction history. metadata is forwarded unmodified so
clients can render merchant name / FX-converted amounts the same way the individual-cards
product already does.

## Path parameters

- `cardAccountId` string, uuid, required

## Query parameters

- `size` integer
- `page` integer
- `from` string, date
- `to` string, date

## Response `200`

Card account transactions fetched successfully

- CardAccountTransactionPage: Base object for paginated list
  - `name` string: Descriptive name for the list
  - `size` integer: Positive integer
  - `totalItems` integer: Positive integer
  - `nextPage` integer: Positive integer
  - `previousPage` integer: Positive integer
  - `content` CardAccountTransaction[], required
    - `reference` string
    - `type` string
    - `status` string
    - `amount` number
    - `feeAmount` number
    - `currency` string
    - `createdAt` string, date-time
    - `description` string
    - `metadata` object

## Other responses

- `401`: Client is not authorized to make request
- `403`: Expected permission is not available.
- `404`: Entity was not found
- `default`: Internal Server Error

## Changes

- **2026-09-26** `a05e89486350`: 1 info
  - added the optional property `allOf[subschema #2]/content/items/description` to the response with the `200` status
- **2026-09-03** `1805362fe220`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nestechops/apis/onboard-external-api-gateway/changes/ledger/card-accounts/:cardAccountId/transactions/get.md)

---

[API](https://skmtc.dev/nestechops/apis/onboard-external-api-gateway.md) - [All operations](https://skmtc.dev/nestechops/apis/onboard-external-api-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/nestechops/apis/onboard-external-api-gateway/revisions/5da9ec1b2573?raw)