VerdifaX

GET /runs/{id}

Returns the full record for a single run, including the complete ExecutionManifest JSON.

Request

GET /runs/{id}
X-Verdifax-Key: vfx_...

Response

{
  "ok": true,
  "id": 42,
  "created_at": "2026-04-30T03:35:04.123Z",
  "payload_hash": "abcd1234...",
  "program_id": "aaaa...",
  "route_id": "route-test",
  "manifest_hash": "6c1428f81519c5bb...",
  "duration_ms": 3,
  "status": "ok",
  "error_stage": "",
  "error_message": "",
  "manifest": {
    "EnvelopeID": "env-...",
    "EnvelopeHash": "...",
    "...": "all 18 sealed fields"
  }
}

payload_hash is the SHA-256 of the original payload bytes. The original payload is not stored — only its hash. This is intentional: regulators need to verify a run happened, not retrieve the underlying input.

404 Not Found if the run id doesn't exist or the caller's API key is not the one that produced it (key-scoped lookup).

Example

curl -s http://localhost:9090/runs/42 \
  -H "X-Verdifax-Key: vfx_..." | python3 -m json.tool

Continue