Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.have-foresight.app/llms.txt

Use this file to discover all available pages before exploring further.

An encounter is the clinical event (visit, procedure, telehealth session). Foresight ingests encounter notes, derives medical codes, and batches them into claims.

​
Create an encounter

POST /v1/encounters
Either with structured codes already in hand, or with raw clinical notes (Foresight derives codes for you).

​
Derive codes from notes

POST /v1/encounters/{id}/derive-codes
Returns suggested ICD-10, CPT, and HCPCS codes with confidence scores and the source span in the note.

​
Provenance

Every suggestion is traceable back to its source — note span, model version, prompt hash: 
GET /v1/encounters/{id}/provenance
Required for audit/compliance reviews and for explaining decisions to payers when challenged.

​
Batch into claims

POST /v1/encounters/batch-create-claims
Groups encounters by patient + insurance + service date into draft claims.

​
Reference