> ## 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 Admission

> Record the mined transaction that listed a record wallet on a whitelist

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

## What the confirm reads

The record must be `APPROVED`, and `listId` must be a whitelist bound to the record's source. The transaction is then verified the same way [Confirm Whitelist Members](https://docs.trusset.org/endpoints/lending/confirm-access-list-members.md) verifies it: it must be mined and successful, and every wallet it listed or removed is read from the list's `AccountListed` events and written to the whitelist's record.

After that the whitelist's record must hold this record's wallet as listed. When it does not, because the transaction listed other wallets only, the call is refused with `TX_DID_NOT_LIST_WALLET`. What the transaction did change on the list stays recorded.

The wallet passes every gate the list serves from the moment 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: `admissions[].listId` from [Approve KYC Record](https://docs.trusset.org/endpoints/customers/approve-kyc-record.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 `true` 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 admission is written to the customer audit log as `KYC_RECORD_ADMITTED`, 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/admission/confirm" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "listId": "cmv2k8q1d0004l70a3n6p2w9e",
    "txHash": "0x4c1f8a6e2d9b07c35e8a1f4d6b2c90e7a3d5f18c6b4e2a09d7c1f3e5b8a6d204"
  }'
```

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

if (!success && error.code === 'TX_NOT_FOUND') {
  // Not mined yet. Wait for one confirmation and confirm again.
}
```

```json Response theme={null}
{
  "success": true,
  "data": {
    "record": {
      "id": "cmhw3k9t20007l80c5q2x7m4d",
      "envelopeId": "75aa6ca04ca5ab4223136c3bea128de0",
      "sourceId": "cmhw2a6r10003l80c9d4h1n8v",
      "sourceName": "Hanse Haftungsdach GmbH",
      "walletAddress": "0x8ba1f109551bD432803012645Ac136ddd64DBA72",
      "profileKey": "PROFESSIONAL",
      "status": "APPROVED",
      "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": null,
      "revokeReason": null,
      "expiredAt": null,
      "customerId": "cmhw3m2p40009l80c1r6t8y3b",
      "sealedBytes": 240964,
      "held": false,
      "lists": [
        {
          "listId": "cmv2k8q1d0004l70a3n6p2w9e",
          "name": "Depositors Q4",
          "address": "0x7d31e6b09a4c25f8e1b73d0a6c94e2f58b1a0c37",
          "listed": true
        }
      ],
      "action": null
    },
    "confirmation": {
      "list": {
        "id": "cmv2k8q1d0004l70a3n6p2w9e",
        "name": "Depositors Q4",
        "purpose": "DEPOSITOR",
        "address": "0x7d31e6b09a4c25f8e1b73d0a6c94e2f58b1a0c37",
        "ownerWallet": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52",
        "pendingOwnerWallet": null,
        "managers": [],
        "memberCount": 148,
        "archived": false,
        "createdTxHash": "0x3f6c0e7a91d24b58c06e1f9a7b3d25e48c17a0f9d63e2b51a84c7f0e9d16b23a",
        "createdBlock": 9384120,
        "syncedBlock": 9611408,
        "createdAt": "2026-10-08T14:02:11.000Z",
        "updatedAt": "2026-11-12T10:19:27.000Z",
        "own": true
      },
      "applied": 1,
      "skipped": 0,
      "events": 1,
      "listedCount": 1,
      "removedCount": 0,
      "txHash": "0x4c1f8a6e2d9b07c35e8a1f4d6b2c90e7a3d5f18c6b4e2a09d7c1f3e5b8a6d204",
      "signedBy": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52"
    }
  },
  "error": null,
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-11-12T10:19:27.305Z"
  }
}
```

## 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_LIST_WALLET` | `400` | The transaction did not list this record's wallet on the whitelist. `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 |
| `RECORD_NOT_APPROVED` | `409` | The record is not `APPROVED`. `details.status` is its status |
| `RATE_LIMIT_EXCEEDED` | `429` | Your instance went over its budget of 120 KYC record writes per minute |
| `CONFIRM_KYC_ADMISSION_FAILED` | `500` | The admission 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.