> ## 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 Record Key

> The public key your KYC sources seal records to

Returns the record key registered for your instance, the keys it replaced, and how many records are waiting to be opened. The record key is the public half of an X25519 key pair your [local tool](https://docs.trusset.org/tools/kyc-courier/overview.md) creates. Every [KYC source](https://docs.trusset.org/endpoints/customers/list-kyc-sources.md) seals its records to it. See [Sealed KYC records](https://docs.trusset.org/endpoints/customers/introduction.md#sealed-kyc-records).

Only the public key is held here. The private half stays in the keystore of your tool, and no endpoint accepts it.

## Response Fields

**data** `object`

**recipientKey** `object`

The key in use, or `null` when none is registered.

**keyId** `string`

The first 16 hex characters of the SHA-256 hash of the raw public key. Envelope headers name the key by this ID.

**publicKey** `string`

The X25519 public key, 64 lowercase hex characters.

**fingerprint** `string`

The first 32 hex characters of the same hash, in 8 groups of 4. Compare it with `trusset-kyc key show` on your own machine to check that the right key is registered. Read your fingerprint to a source from `trusset-kyc key show`, never from this response: it comes from Trusset, and the source checks the invite, which also comes from Trusset, against what you read out.

**createdAt** `string`

When it was registered, ISO 8601.

**history** `array`

Up to 50 keys of the instance, newest first, the key in use included. Each is `{ keyId, fingerprint, createdAt, retiredAt }`. `retiredAt` is `null` for the key in use.

**pendingRecords** `integer`

Records in status `RECEIVED`, which your tool has not opened yet.

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

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

if (!data.recipientKey) {
  throw new Error('No record key registered. Run trusset-kyc keygen and register the public key.');
}
```

```json Response theme={null}
{
  "success": true,
  "data": {
    "recipientKey": {
      "keyId": "b9619d9be69ed903",
      "publicKey": "d523432543eb506e3fbe5538bc2409ab97d016a8a8823ef0a7d416ac60967033",
      "fingerprint": "b961 9d9b e69e d903 c31c 6f1a f3c6 a7d2",
      "createdAt": "2026-11-09T08:12:44.310Z"
    },
    "history": [
      {
        "keyId": "b9619d9be69ed903",
        "fingerprint": "b961 9d9b e69e d903 c31c 6f1a f3c6 a7d2",
        "createdAt": "2026-11-09T08:12:44.310Z",
        "retiredAt": null
      }
    ],
    "pendingRecords": 3
  },
  "error": null,
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-11-12T09:20:00.000Z"
  }
}
```

## Error Codes

| Code | HTTP | Cause |
| - | - | - |
| `RATE_LIMIT_EXCEEDED` | `429` | Your instance went over its budget of 240 KYC record reads per minute. See [Rate limits](https://docs.trusset.org/endpoints/customers/introduction.md#rate-limits) |
| `KYC_RECIPIENT_KEY_FAILED` | `500` | The key could not be read |


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