Deliveries
Get Delivery Status
What happened to a record you delivered
GET
/
kyc-inbox
/
{sourceId}
/
records
/
{envelopeId}
curl "https://api.trusset.org/kyc-inbox/cmhw2a6r10003l80c9d4h1n8v/records/75aa6ca04ca5ab4223136c3bea128de0" \
-H "Authorization: Bearer tki_your_token_here"
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}`);
}
{
"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"
}
}
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
Response Fields
Show child attributes
Show child attributes
The
recordDigest from your header. Revoke Record takes it.RECEIVED, OPENED, APPROVED, REJECTED, REVOKED, EXPIRED, UNCLAIMED or SUPERSEDED. See What happens to a record.BAD_SIGNATURE, DIGEST_MISMATCH, UNKNOWN_SOURCE_KEY, UNDECRYPTABLE, INCOMPLETE or NOT_ACCEPTED, or null.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.curl "https://api.trusset.org/kyc-inbox/cmhw2a6r10003l80c9d4h1n8v/records/75aa6ca04ca5ab4223136c3bea128de0" \
-H "Authorization: Bearer tki_your_token_here"
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}`);
}
{
"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 |
KYC_STATUS_FAILED | 500 | The status could not be read |
⌘I
curl "https://api.trusset.org/kyc-inbox/cmhw2a6r10003l80c9d4h1n8v/records/75aa6ca04ca5ab4223136c3bea128de0" \
-H "Authorization: Bearer tki_your_token_here"
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}`);
}
{
"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"
}
}
