COMMON HEADERS
Authorization: Bearer <token> X-Correlation-Id: <uuid> Idempotency-Key: <uuid> X-Request-Timestamp: <RFC3339> Content-Type: application/json
REFERENCE API CONTRACT
Reference API published for assets, challenges, proofs, activity, screening and reports.
RESOURCE MODEL
| Method | Endpoint | Purpose |
|---|---|---|
POST | /v1/assets | Register wallet or digital-asset assertion |
POST | /v1/challenges | Create a proof-of-control challenge |
POST | /v1/proofs/verify | Verify an approved signed challenge |
GET | /v1/assets/{assetId}/report | Export the assurance report |
COMMON HEADERS
Authorization: Bearer <token> X-Correlation-Id: <uuid> Idempotency-Key: <uuid> X-Request-Timestamp: <RFC3339> Content-Type: application/json
REQUEST ENVELOPE
{
"profileId": "QS-AA-2026.07",
"requestId": "5fda47cb-55c8-45a8-81a6-2dd1d1938b47",
"mode": "controlled-evaluation",
"evidenceRequired": true
}ERROR MODEL
400 — Invalid schema or unsupported profile401/403 — Authentication or policy denial409 — Idempotency or state conflict422 — Evidence or compatibility requirement not met503 — Protected dependency unavailable; fail-closed unless approved otherwiseVERSIONING
IMPLEMENTATION PATH
Validate the API contract together with the test corpus and readiness passport.