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

# Get KYC Record

> One sealed KYC record with its state and whitelists

Returns one sealed KYC record: its clear header fields, its status, the whitelists bound to its source and the next step that is yours. The KYC file itself is not returned. While the record is `RECEIVED`, [Download Envelope](https://docs.trusset.org/endpoints/customers/get-kyc-record-envelope.md) returns its ciphertext.

## Path Parameters

**recordId** `string` *required*

The record `id` from [List KYC Records](https://docs.trusset.org/endpoints/customers/list-kyc-records.md), or the `recordId` of a `customer.kyc_record_received` event.

## Response Fields

**data** `object`

**record** `object`

The record, with the fields described on [List KYC Records](https://docs.trusset.org/endpoints/customers/list-kyc-records.md#response-fields).

```bash cURL theme={null}
curl "https://api.trusset.org/customers/api/kyc-records/cmhw3k9t20007l80c5q2x7m4d" \
  -H "X-API-Key: trusset_your_key_here"
```

```typescript TypeScript theme={null}
const res = await fetch(
  `https://api.trusset.org/customers/api/kyc-records/${recordId}`,
  { headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();

if (data.record.action === 'APPROVE') {
  // The file is in your records folder. Review it, then approve or reject.
}
```

```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
    }
  },
  "error": null,
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-11-12T10:21:44.000Z"
  }
}
```

## Error Codes

| Code | HTTP | Cause |
| - | - | - |
| `RECORD_NOT_FOUND` | `404` | No KYC record with this ID belongs to your instance |
| `RATE_LIMIT_EXCEEDED` | `429` | Your instance went over its budget of 240 KYC record reads per minute |
| `GET_KYC_RECORD_FAILED` | `500` | The record could not be read |


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