> ## 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 Delivery Status

> What happened to a record you delivered

Returns where a delivered record stands at the bank: whether it was opened, approved, rejected or revoked, and whether its wallet is listed on the bank's whitelists. You see only records delivered through your own inbox, looked up by the `envelopeId` you chose.

The answer holds what your header already stated plus the bank's decisions. It never returns anything from inside the record.

## Path Parameters

**sourceId** `string` *required*

Your source ID, from the invite.

**envelopeId** `string` *required*

The `envelopeId` of the delivery, 32 lowercase hex characters.

## Response Fields

**data** `object`

**envelopeId** `string`

The envelope ID.

**recordDigest** `string`

The `recordDigest` from your header. [Revoke Record](https://docs.trusset.org/endpoints/kyc-inbox/revoke-record.md) takes it.

**walletAddress** `string`

The wallet, checksummed.

**status** `string`

`RECEIVED`, `OPENED`, `APPROVED`, `REJECTED`, `REVOKED`, `EXPIRED`, `UNCLAIMED` or `SUPERSEDED`. See [What happens to a record](https://docs.trusset.org/endpoints/kyc-inbox/introduction.md#what-happens-to-a-record).

**receivedAt** `string`

When Trusset received the envelope, ISO 8601.

**openedAt** `string`

When the bank proved it decrypted the record, or `null`.

**approvedAt** `string`

When the bank approved it, or `null`.

**rejectedAt** `string`

When it was rejected, or `null`.

**rejectReason** `string`

`BAD_SIGNATURE`, `DIGEST_MISMATCH`, `UNKNOWN_SOURCE_KEY`, `UNDECRYPTABLE`, `INCOMPLETE` or `NOT_ACCEPTED`, or `null`.

**revokedAt** `string`

When you revoked it, or `null`.

**validUntil** `string`

The `validUntil` from your header.

**admitted** `boolean`

`true` when the record is `APPROVED` and the bank's records show the wallet listed on every whitelist bound to your source. `false` otherwise. `null` when the bank bound no whitelist to your source.

> [!NOTE]
>
> `admitted` follows the whitelist records the bank confirmed on Trusset. A listing takes effect on chain when the bank's transaction mines, which can be before the bank confirms it.

```bash cURL theme={null}
curl "https://api.trusset.org/kyc-inbox/cmhw2a6r10003l80c9d4h1n8v/records/75aa6ca04ca5ab4223136c3bea128de0" \
  -H "Authorization: Bearer tki_your_token_here"
```

```typescript TypeScript theme={null}
const res = await fetch(
  `${invite.api}/kyc-inbox/${invite.sourceId}/records/${envelopeId}`,
  { headers: { Authorization: `Bearer ${invite.token}` } }
);
const { data } = await res.json();

if (data.status === 'REJECTED') {
  console.warn(`Rejected by the bank: ${data.rejectReason}`);
}
```

```json Response theme={null}
{
  "success": true,
  "data": {
    "envelopeId": "75aa6ca04ca5ab4223136c3bea128de0",
    "recordDigest": "565dd632e69c3630319efbd08052d5fd1dfbdd5b1123b31e227502261fae5b9d",
    "walletAddress": "0x8ba1f109551bD432803012645Ac136ddd64DBA72",
    "status": "APPROVED",
    "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,
    "validUntil": "2027-11-10T23:59:59.999Z",
    "admitted": true
  },
  "error": null,
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-11-12T10:30:00.000Z"
  }
}
```

## Error Codes

| Code | HTTP | Cause |
| - | - | - |
| `UNAUTHORIZED` | `401` | The token is missing, malformed or wrong, the `sourceId` is unknown, or the bank removed the source |
| `RECORD_NOT_FOUND` | `404` | No record with this `envelopeId` was delivered through your inbox |
| `RATE_LIMIT_EXCEEDED` | `429` | A rate limit was exceeded. See [Rate limits](https://docs.trusset.org/endpoints/kyc-inbox/introduction.md#rate-limits) |
| `KYC_STATUS_FAILED` | `500` | The status could not be read |


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