API Reference

Event Ingestion API

Submit verification events from external systems into TruSolve. Each event is processed through our deterministic verification engine and generates a verification artifact.

Endpoint

POST/api/ingest

Request Body

JSON Payloadapplication/json

{
  "tenant_id": "northbridge_financial",
  "event_type": "advisory_action",
  "client_id": "CL-88211",
  "advisor_id": "ADV-221",
  "risk_profile": "moderate",
  "disclosure_confirmed": true,
  "document_hash": "doc_8821f3",
  "created_at": "2026-03-07T09:22:00Z"
}

Required Fields

tenant_idstringUnique identifier for the institution

event_typestringType of verification event

created_atstringISO 8601 timestamp of the event

Optional Fields

Additional fields can be included based on event type. All fields are included in the event hash computation.

client_idstringClient identifier

advisor_idstringAdvisor identifier

document_hashstringHash of related document

risk_profilestringRisk assessment level

disclosure_confirmedbooleanDisclosure acknowledgment

Response

Success Response200 OK

{
  "status": "verified",
  "artifact_id": "art_92f1c81",
  "event_hash": "0x88f23a7d",
  "state_root": "0x2a9c1f88",
  "timestamp": "2026-03-07T09:22:01Z"
}

statusVerification result ("verified" or "failed")

artifact_idUnique identifier for the verification artifact

event_hashDeterministic hash of the event payload

state_rootUpdated global state root after verification

timestampServer timestamp when artifact was created

Supported Event Types

advisory_action

Financial advisory interaction or recommendation

compliance_event

Compliance-related activity or filing

policy_update

Policy or procedure modification

client_disclosure

Client communication or disclosure

risk_assessment

Risk evaluation or scoring event

audit_verification

Audit-related verification request

grant_allocation

Nonprofit grant or fund allocation

patient_record

Healthcare patient record event

API Tester

Send a test request

Request Payload