§01
Authentication
OAuth 2.0 with PKCE.
Per-clinician scoped tokens. Refresh tokens rotate on use. SCIM provisioning available on Clinic tier.
Vertix/Resources · Developers
API documentationBETA
FHIR R4 · OAuth 2.0 · Webhooks.
REST API on top of FHIR R4. OAuth 2.0 with PKCE. Outbound webhooks for encounter, outcome, and audit-log events.
§02
Endpoints
Encounter · Outcome · Citation · Audit.
- GET /v1/encounter/:id · Pull a fully formed encounter
- POST /v1/encounter · Submit a session for analysis
- GET /v1/outcome/:patient_id · Longitudinal PHQ-9 / GAD-7 / PCL-5
- POST /v1/citation/lookup · Resolve a DOI to a Vertix evidence record
- GET /v1/audit-log · 30-day rolling encounter audit trail
§03
Webhooks
Push events to your stack.
- encounter.completed · Fires when documentation is finalized
- outcome.threshold · Fires on responder / non-responder threshold cross
- audit.exported · Fires on audit-log export
Talk to the team that built this.
If your clinic has more specific requirements (BAA, on-prem, custom paradigm engines), we'll walk you through them.