Skip to main content
GET
/
v1
/
compliance
/
proof
/
{screeningId}
curl https://api.engram.training/v1/compliance/proof/d3b1649c-1ede-4bc7-adc3-a8fadf6b254c \
  -H "Authorization: Bearer sk_live_..."

{
  "proof": {
    "version": 1,
    "screeningId": "d3b1649c-1ede-4bc7-adc3-a8fadf6b254c",
    "timestamp": "2026-04-05T17:30:47.758Z",
    "resultsHash": "0c17939f1da5e18806deae3444851c9f6f286d3b...",
    "dataSources": ["ofac_sdn", "opensanctions", "community"],
    "dataSnapshots": {
      "ofac_sdn": {
        "blobName": "compliance/ofac_sdn/0cf0c1e8-....json",
        "shelbyUrl": "https://api.testnet.shelby.xyz/..."
      },
      "opensanctions": {
        "blobName": "compliance/opensanctions/aa642ba0-....json",
        "shelbyUrl": "https://api.testnet.shelby.xyz/..."
      }
    },
    "agentId": "c836ec60-...",
    "developerId": "25fc879f-...",
    "addressCount": 1,
    "results": [
      {
        "address": "12QtD5BFwRsdNsAZY76UVE1xyCGNTojH9h",
        "chain": "bitcoin",
        "status": "sanctioned",
        "matchCount": 2,
        "sources": ["ofac_sdn", "opensanctions"]
      }
    ]
  },
  "shelbyUrl": "https://api.testnet.shelby.xyz/.../compliance/proofs/d3b1649c-....json",
  "disclaimer": "This proof was uploaded to Shelby at screening time. Verify independently at the shelbyUrl."
}

​
Path Parameters

​
screeningId
string
required
The screening ID returned from a POST /v1/compliance/screen call.

​
Response

​
proof
object
The full screening proof envelope.
​
shelbyUrl
string
Direct URL to the proof blob on Shelby. Visit this URL to independently verify the proof content.

​
How to Verify

  1. Fetch the proof via this endpoint (or directly from the shelbyUrl)
  2. Download the data snapshots referenced in dataSnapshots
  3. Re-run the screening logic against the snapshot data
  4. Compare your computed results hash against resultsHash
If the hashes match, the screening result has not been tampered with. 
curl https://api.engram.training/v1/compliance/proof/d3b1649c-1ede-4bc7-adc3-a8fadf6b254c \
  -H "Authorization: Bearer sk_live_..."

{
  "proof": {
    "version": 1,
    "screeningId": "d3b1649c-1ede-4bc7-adc3-a8fadf6b254c",
    "timestamp": "2026-04-05T17:30:47.758Z",
    "resultsHash": "0c17939f1da5e18806deae3444851c9f6f286d3b...",
    "dataSources": ["ofac_sdn", "opensanctions", "community"],
    "dataSnapshots": {
      "ofac_sdn": {
        "blobName": "compliance/ofac_sdn/0cf0c1e8-....json",
        "shelbyUrl": "https://api.testnet.shelby.xyz/..."
      },
      "opensanctions": {
        "blobName": "compliance/opensanctions/aa642ba0-....json",
        "shelbyUrl": "https://api.testnet.shelby.xyz/..."
      }
    },
    "agentId": "c836ec60-...",
    "developerId": "25fc879f-...",
    "addressCount": 1,
    "results": [
      {
        "address": "12QtD5BFwRsdNsAZY76UVE1xyCGNTojH9h",
        "chain": "bitcoin",
        "status": "sanctioned",
        "matchCount": 2,
        "sources": ["ofac_sdn", "opensanctions"]
      }
    ]
  },
  "shelbyUrl": "https://api.testnet.shelby.xyz/.../compliance/proofs/d3b1649c-....json",
  "disclaimer": "This proof was uploaded to Shelby at screening time. Verify independently at the shelbyUrl."
}