API Reference & Overview

Sanafin APIs bridge the gap between healthcare data streams and financial settlement. Securely ingest clinical evidence and orchestrate programmatic escrows to execute value-based contracts automatically.

Authentication

Secure requests using live and sandbox API keys passed in request authorization headers.

Standard Formats

Full support for standard JSON payloads, mapping easily to HL7 FHIR Observation schemas.

Idempotency

All contract and escrow creations support idempotency keys to ensure zero double-funding errors.

POST/v1/evidence/ingest

Connecting real-world health evidence

Use this endpoint to feed patient health indicators and biomarkers directly into Sanafin to verify active contracts. Sanafin parses digital biomarkers and lab reports (e.g., HbA1c tests) to assess outcome target success.

Payload Parameters

contract_idrequired

string

Unique identifier of the target value-based contract.

data_sourcerequired

string (enum)

The origin of the health evidence. Must be lab_feed, wearable, or ehr_record.

payload.biomarkerrequired

string

The clinical code/name of the metric being verified (e.g. HbA1c or Steps).

REQUEST PAYLOAD

curl -X POST https://api.sanafin.tech/v1/evidence/ingest \
  -H "Authorization: Bearer sf_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "contract_id": "con_892f3a8b9",
    "patient_id": "pat_swiss_4091",
    "data_source": "lab_feed",
    "evidence_type": "biomarker_reading",
    "timestamp": "2026-06-22T08:12:00Z",
    "payload": {
      "biomarker": "HbA1c",
      "value": 5.6,
      "unit": "percent",
      "verified_by": "lab_synlab_geneva",
      "fhir_reference": "Observation/obs-9921-hba1c"
    }
  }'

EXPECTED RESPONSE

200 OK

{
  "status": "received",
  "evidence_id": "ev_091f27a3c",
  "received_at": "2026-06-22T08:12:01Z",
  "validation": {
    "schema_check": "passed",
    "provider_check": "synlab_verified"
  },
  "contract_impact": {
    "action": "contract_updated",
    "state": "pending_payout_evaluation"
  }
}

Request Sandbox Access

Establish value-based clinical contracts inside our developer sandbox. Contact us for mock evidence scripts, HL7 validator keys, and staging endpoints.

Get Sandbox Credentials