---
title: "Replace an existing account holder."
method: PUT
path: "/v2/account-holder/{account_holder_id}"
tags: ["Account Holder"]
---

# Replace an existing account holder.

`PUT /v2/account-holder/{account_holder_id}`

Replace a existing account holder and start tracking its ledger. The account holder can be a consumer, business or unknown.

## Path parameters

- `account_holder_id` string, required

## Request body

- AccountHolderWrite
  - `type` 'consumer' | 'business' | 'unknown', required
  - `name` string, nullable
  - `industry` string, nullable
  - `website` string, nullable
  - `company` AccountHolderCompany
    - `loan_state` 'tbd' | 'ongoing' | 'done', required
    - `logo` string, nullable

## Response `200`

Replaced account holder

- NtropyServerSchemasAccountHolderAccountHolder
  - `type` 'consumer' | 'business' | 'unknown', required
  - `name` string, nullable
  - `industry` string, nullable
  - `website` string, nullable
  - `company` AccountHolderCompany
    - `loan_state` 'tbd' | 'ongoing' | 'done', required
    - `logo` string, nullable
  - `id` string, required
  - `created_at` string, date-time, nullable
  - `mean_labeler_confidence` number, nullable
  - `total_revenue` number, nullable
  - `application_time` string, date-time, nullable
  - `alerts` object
  - `review_percentage` number, nullable

## Other responses

- `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/versions/47be508488c1/schema)