> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trusset.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Confirm Record Removal

> Record the mined transaction that took a record wallet off a whitelist

Verifies the mined `setListed` transaction that [Build Record Removal](https://docs.trusset.org/endpoints/customers/build-kyc-record-removal.md) returned for one whitelist, and records that the record's wallet is no longer listed. Confirm once per whitelist, each with its own transaction hash.

`listId` must be a whitelist bound to the record's source. The transaction is verified the same way [Confirm Whitelist Members](https://docs.trusset.org/endpoints/lending/confirm-access-list-members.md) verifies it, and every wallet it listed or removed is written to the whitelist's record from the list's `AccountListed` events. After that the whitelist's record must no longer hold this record's wallet as listed. When it still does, the call is refused with `TX_DID_NOT_REMOVE_WALLET`.

The removal takes effect on chain when the transaction mines, whether or not it is confirmed here. The confirm keeps the record's `lists[].listed` and `action` in step with the chain.

## Path Parameters

**recordId** `string` *required*

The record `id` from [List KYC Records](https://docs.trusset.org/endpoints/customers/list-kyc-records.md).

## Body Parameters

**listId** `string` *required*

The whitelist the transaction was sent to: `removals[].listId` from [Build Record Removal](https://docs.trusset.org/endpoints/customers/build-kyc-record-removal.md).

**txHash** `string` *required*

Hash of the mined `setListed` transaction, `0x` followed by 64 hex characters.

## Response Fields

**data** `object`

**record** `object`

The record after the call, as on [List KYC Records](https://docs.trusset.org/endpoints/customers/list-kyc-records.md#response-fields). `lists[].listed` is `false` for the confirmed list.

**confirmation** `object`

What the transaction changed on the list, with the fields of [Confirm Whitelist Members](https://docs.trusset.org/endpoints/lending/confirm-access-list-members.md#response-fields): `list`, `applied`, `skipped`, `events`, `listedCount`, `removedCount`, `txHash` and `signedBy`.

> [!NOTE]
>
> The removal is written to the customer audit log as `KYC_RECORD_REMOVED`, with the whitelist, the transaction and the wallet that signed it.

```bash cURL theme={null}
curl -X POST "https://api.trusset.org/customers/api/kyc-records/cmhw3k9t20007l80c5q2x7m4d/removal/confirm" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "listId": "cmv2k8q1d0004l70a3n6p2w9e",
    "txHash": "0x9e3a7c15d8f2046b1a9c5e7d3f08b2a64c1e9d7f5a3b0c82e6d4f1a97b5c3e08"
  }'
```

```typescript TypeScript theme={null}
const res = await fetch(
  `https://api.trusset.org/customers/api/kyc-records/${recordId}/removal/confirm`,
  {
    method: 'POST',
    headers: { 'X-API-Key': 'trusset_your_key_here', 'Content-Type': 'application/json' },
    body: JSON.stringify({ listId: removal.listId, txHash: tx.hash })
  }
);
const { data } = await res.json();
```

```json Response theme={null}
{
  "success": true,
  "data": {
    "record": {
      "id": "cmhw3k9t20007l80c5q2x7m4d",
      "envelopeId": "75aa6ca04ca5ab4223136c3bea128de0",
      "sourceId": "cmhw2a6r10003l80c9d4h1n8v",
      "sourceName": "Hanse Haftungsdach GmbH",
      "walletAddress": "0x8ba1f109551bD432803012645Ac136ddd64DBA72",
      "profileKey": "PROFESSIONAL",
      "status": "REVOKED",
      "recordDigest": "565dd632e69c3630319efbd08052d5fd1dfbdd5b1123b31e227502261fae5b9d",
      "recipientKeyId": "b9619d9be69ed903",
      "verifiedAt": "2026-11-10T00:00:00.000Z",
      "validUntil": "2027-11-10T23:59:59.999Z",
      "issuedAt": "2026-11-12T09:14:07.512Z",
      "receivedAt": "2026-11-12T09:14:09.204Z",
      "openedAt": "2026-11-12T09:40:31.870Z",
      "approvedAt": "2026-11-12T10:15:02.336Z",
      "rejectedAt": null,
      "rejectReason": null,
      "revokedAt": "2027-02-03T08:40:13.027Z",
      "revokeReason": "WITHDRAWN",
      "expiredAt": null,
      "customerId": "cmhw3m2p40009l80c1r6t8y3b",
      "sealedBytes": 240964,
      "held": false,
      "lists": [
        {
          "listId": "cmv2k8q1d0004l70a3n6p2w9e",
          "name": "Depositors Q4",
          "address": "0x7d31e6b09a4c25f8e1b73d0a6c94e2f58b1a0c37",
          "listed": false
        }
      ],
      "action": null
    },
    "confirmation": {
      "list": {
        "id": "cmv2k8q1d0004l70a3n6p2w9e",
        "name": "Depositors Q4",
        "purpose": "DEPOSITOR",
        "address": "0x7d31e6b09a4c25f8e1b73d0a6c94e2f58b1a0c37",
        "ownerWallet": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52",
        "pendingOwnerWallet": null,
        "managers": [],
        "memberCount": 147,
        "archived": false,
        "createdTxHash": "0x3f6c0e7a91d24b58c06e1f9a7b3d25e48c17a0f9d63e2b51a84c7f0e9d16b23a",
        "createdBlock": 9384120,
        "syncedBlock": 10204771,
        "createdAt": "2026-10-08T14:02:11.000Z",
        "updatedAt": "2027-02-03T09:06:15.000Z",
        "own": true
      },
      "applied": 1,
      "skipped": 0,
      "events": 1,
      "listedCount": 0,
      "removedCount": 1,
      "txHash": "0x9e3a7c15d8f2046b1a9c5e7d3f08b2a64c1e9d7f5a3b0c82e6d4f1a97b5c3e08",
      "signedBy": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52"
    }
  },
  "error": null,
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2027-02-03T09:06:15.240Z"
  }
}
```

## Error Codes

| Code | HTTP | Cause |
| - | - | - |
| `ACCESS_LIST_NOT_BOUND` | `400` | `listId` is missing or is not a whitelist bound to the record's source. `details.field` is `listId` |
| `INVALID_TX` | `400` | `txHash` is missing or is not `0x` followed by 64 hex characters |
| `TX_REVERTED` | `400` | The transaction was mined but reverted |
| `TX_WRONG_TARGET` | `400` | The transaction neither called this whitelist nor emitted an `AccountListed` event from it |
| `TX_WRONG_FUNCTION` | `400` | The transaction called this whitelist with a function other than `setListed` |
| `TX_NOT_VERIFIED` | `400` | The transaction listed or removed no wallet on this whitelist |
| `TX_DID_NOT_REMOVE_WALLET` | `400` | The whitelist's record still holds this record's wallet as listed after the transaction. `details.txHash` is the transaction |
| `TX_NOT_FOUND` | `404` | No receipt yet. The transaction is unmined, dropped, or on another network. Wait for one confirmation and confirm again |
| `RECORD_NOT_FOUND` | `404` | No KYC record with this ID belongs to your instance |
| `INSTANCE_NOT_FOUND` | `404` | The instance behind your key is archived or no longer exists |
| `ACCESS_LIST_NOT_FOUND` | `404` | The whitelist is no longer kept or managed by your instance on this network |
| `RATE_LIMIT_EXCEEDED` | `429` | Your instance went over its budget of 120 KYC record writes per minute |
| `CONFIRM_KYC_REMOVAL_FAILED` | `500` | The removal could not be recorded |
| `ACCESS_LISTS_NOT_CONFIGURED` | `501` | The whitelist factory is not deployed on your instance's network |
| `ACCESS_LIST_UNREADABLE` | `503` | The list belongs to another instance and whether your wallets still manage it could not be read. Retry shortly |

The confirm call can also return any [transaction verification error](https://docs.trusset.org/endpoints/introduction.md#confirm-a-transaction).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.