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

# List KYC Sources

> The verifiers your instance accepts sealed KYC records from

Returns the KYC sources of your instance, newest first, with the record key they seal to. A KYC source is a verifier you designate, for example the liability umbrella that verified an investor at the time of investment. It delivers the KYC file of a wallet as a sealed envelope through its [inbox](https://docs.trusset.org/endpoints/kyc-inbox/introduction.md). See [Sealed KYC records](https://docs.trusset.org/endpoints/customers/introduction.md#sealed-kyc-records).

Up to 200 sources are returned, removed ones included.

| `status` | Meaning |
| - | - |
| `ACTIVE` | The source can deliver and revoke records |
| `PAUSED` | Deliveries are refused with `403 SOURCE_PAUSED`. The source can still read its inbox and delivery status, and revoke records |
| `REVOKED` | Removed with [Remove KYC Source](https://docs.trusset.org/endpoints/customers/remove-kyc-source.md). Its token no longer works. Final |

## Response Fields

**data** `object`

**sources** `array`

**id** `string`

The source ID. It is part of the inbox URL and of every envelope header.

**name** `string`

The name you gave the source.

**signingKey** `string`

The Ed25519 public key the source signs with, 64 lowercase hex characters.

**signingKeyFingerprint** `string`

The first 32 hex characters of the SHA-256 hash of the raw key, in 8 groups of 4.

**profileKey** `string`

The [verification profile](https://docs.trusset.org/endpoints/customers/list-verification-profiles.md) the source verifies for. A delivery under another profile key is refused.

**accessLists** `array`

The whitelists bound to the source, each `{ id, name, address }`. [Approve KYC Record](https://docs.trusset.org/endpoints/customers/approve-kyc-record.md) returns the listing transaction for each of them. Empty when none is bound.

**status** `string`

`ACTIVE`, `PAUSED` or `REVOKED`.

**tokenHint** `string`

The last 4 characters of the source's current token, or `----` for a removed source. The token itself is shown only inside the invite.

**tokenIssuedAt** `string`

When the current token was issued, ISO 8601.

**lastDeliveryAt** `string`

When the source last delivered a record, or `null`.

**createdAt** `string`

ISO 8601.

**counts** `object`

`{ received, opened, approved }`: the source's records in each of those statuses.

**recipientKey** `object`

The record key in use: `{ keyId, publicKey, fingerprint }`, or `null` when none is registered.

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

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

const active = data.sources.filter((source) => source.status === 'ACTIVE');
```

```json Response theme={null}
{
  "success": true,
  "data": {
    "sources": [
      {
        "id": "cmhw2a6r10003l80c9d4h1n8v",
        "name": "Hanse Haftungsdach GmbH",
        "signingKey": "c201dc3ced8549ad4e07400a868d9fd043a8d316e7141989c33e8f2f5f844fd6",
        "signingKeyFingerprint": "4b37 6734 b088 268b 89d3 cf6d 1a88 0a1c",
        "profileKey": "PROFESSIONAL",
        "accessLists": [
          {
            "id": "cmv2k8q1d0004l70a3n6p2w9e",
            "name": "Depositors Q4",
            "address": "0x7d31e6b09a4c25f8e1b73d0a6c94e2f58b1a0c37"
          }
        ],
        "status": "ACTIVE",
        "tokenHint": "Qml8",
        "tokenIssuedAt": "2026-11-09T08:31:02.118Z",
        "lastDeliveryAt": "2026-11-12T09:14:09.204Z",
        "createdAt": "2026-11-09T08:31:02.118Z",
        "counts": { "received": 3, "opened": 1, "approved": 12 }
      }
    ],
    "recipientKey": {
      "keyId": "b9619d9be69ed903",
      "publicKey": "d523432543eb506e3fbe5538bc2409ab97d016a8a8823ef0a7d416ac60967033",
      "fingerprint": "b961 9d9b e69e d903 c31c 6f1a f3c6 a7d2"
    }
  },
  "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 120 KYC source reads per minute. See [Rate limits](https://docs.trusset.org/endpoints/customers/introduction.md#rate-limits) |
| `LIST_KYC_SOURCES_FAILED` | `500` | The sources could not be read |


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