---
title: "Identify existing recurring payments for an account holder's transaction history."
method: POST
path: "/v2/account-holder/{account_holder_id}/recurring-payments"
tags: ["Account Holder"]
---

# Identify existing recurring payments for an account holder's transaction history.

`POST /v2/account-holder/{account_holder_id}/recurring-payments`

Given the history of transactions of an account holder, determines existing recurring payments and related properties such as the type (subscription or bill), amount, periodicity, etc...

## Path parameters

- `account_holder_id` string, required

## Response `200`

Result containing existing RecurringPaymentsGroups for an account holder.

- RecurringPaymentsGroup[]
  - `recurrence_group_id` string, required
  - `periodicity` 'daily' | 'weekly' | 'bi-weekly' | 'monthly' | 'bi-monthly' | 'quarterly' | 'semi-yearly' | 'yearly' | 'other'
  - `latest_payment_amount` number, required
  - `total_amount` number, required
  - `merchant` string, nullable
  - `merchant_id` string, nullable
  - `logo` string, nullable
  - `website` string, nullable
  - `labels` string[], nullable
  - `first_payment_date` string, required
  - `latest_payment_date` string, required
  - `transaction_ids` string[], required
  - `is_active` boolean, required
  - `next_expected_payment_date` string, nullable
  - `latest_payment_description` string, required
  - `type` string, required
  - `is_essential` boolean, required
  - `iso_currency_code` string, required
  - `entry_type` string, required
  - `periodicity_in_days` integer, nullable
  - `average_amount` 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)