---
title: "List transactions of an account holder."
method: GET
path: "/v2/account-holder/{account_holder_id}/transactions"
tags: ["Account Holder"]
---

# List transactions of an account holder.

`GET /v2/account-holder/{account_holder_id}/transactions`

Fetch all the transactions in the transaction ledger of an account holder.

## Path parameters

- `account_holder_id` string, required

## Query parameters

- `page` integer — Page number
- `per_page` integer — How many items per page
- `sort_by` string, nullable — Column to sort items by, allowed values are `['date']`. When not specified the default order will be used.
- `sort_order` 'asc' | 'desc'

## Response `200`

List of transactions for the account holder.

- PaginatedAccountHolderTransactions
  - `transactions` AccountHolderTransaction[], nullable
    - `transaction_id` string, required
    - `account_holder_id` string, nullable — The unique ID of the account holder of the transaction
    - `account_holder_type` 'consumer' | 'business' | 'unknown'
    - `amount` number, required — The amount of the transaction
    - `entry_type` 'incoming' | 'outgoing', required
    - `date` string, date, required — The date that the transaction was posted. Uses ISO 8601 format (YYYY-MM-DD)
    - `iso_currency_code` string, required — The currency of the transaction in ISO 4217 format
    - `description` string, required — The description string of the transaction
    - `location` string, nullable
    - `country` string, nullable — The country where the transaction was made in ISO 3166-2 format
    - `mcc` integer[], nullable
    - `account_holder_name` string, nullable — The name of the account holder
    - `logo` string, nullable
    - `website` string, nullable
    - `location_structured` LocationStructuredPublic
      - `address` string, nullable
      - `city` string, nullable
      - `state` string, nullable
      - `postcode` string, nullable
      - `country` string, nullable
      - `country_name` string, nullable
      - `latitude` number, nullable
      - `longitude` number, nullable
      - `google_maps_url` string, nullable
      - `apple_maps_url` string, nullable
      - `store_number` string, nullable
      - `house_number` string, nullable
    - `merchant` string, nullable
    - `merchant_id` string, nullable
    - `labels` string[], nullable
    - `recurrence` 'recurring' | 'subscription' | 'one off'
    - `recurrence_group` RecurrenceGroup
      - `id` string, required
      - `first_payment_date` string, date, nullable
      - `latest_payment_date` string, date, nullable
      - `total_amount` number, nullable
      - `average_amount` number, nullable
      - `periodicity_in_days` number, nullable
      - `periodicity` string, nullable
      - `confidence` string, nullable
      - `transaction_ids` string[], nullable — IDs of transactions that belong to this group. Due to multiplicity constraints, these are truncated to 100. To obtain the full list, please refer to the [recurring payments API](#/Account%20Holder/get_account_holder_recurring_payments_v2_account_holder__account_holder_id__recurring_payments_post)
    - `recurrence_group_id` string, nullable
    - `person` string, nullable
    - `transaction_type` 'business' | 'consumer' | 'unknown'
    - `intermediaries` EntityOut[], nullable
      - `id` string, nullable
      - `name` string, nullable
      - `website` string, nullable
      - `logo` string, nullable
  - `pages` integer, nullable

## Other responses

- `400` — Bad request
- `404` — Account holder not found.
- `422` — Validation Error

---

[API](https://skmtc.net/ntropy/apis/ntropy-transaction-api.md) · [All operations](https://skmtc.net/ntropy/apis/ntropy-transaction-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ntropy/ntropy-transaction-api/revisions/47be508488c1/schema)