cpt

Code Chart To Cpt

Code the procedures documented in a chart, then scrub the resulting claim.

Five stages: LLM procedure-mention extraction → deterministic retrieval → batched LLM disambiguation → deterministic modifier proposal → deterministic verification.

⚠ Neither LLM call can produce a code. Stage 1 raises on a code-shaped token; Stage 3 chooses from the list retrieval built and verified against the code set. The codes this endpoint can emit are exactly the codes retrieval found — that is a property of the wiring, not of the prompts.

⚠ Read result_state before lines. An empty line list means one of several very different things, and documentation_gap (a chart problem you can act on) is not retrieval_unavailable (our corpus is unbuilt).

⚠ candidate_modifiers are prompts, not decisions. A modifier under applied_modifiers follows from a documented axis and a CMS indicator. One under candidate_modifiers is permitted by the fee schedule but needs the note to support it, and the verification below was run WITHOUT it applied. 59 and 25 are never proposed at all — they assert clinical facts only the documentation establishes.

Requires Pro or Enterprise tier, an executed BAA, and PHI activation.

post/api/v1/cpt/code

Request

  • Base URL: https://api.accurecord.io (the document declares no server; this is the origin it was published from)
  • URL: https://api.accurecord.io/api/v1/cpt/code
  • Auth: none declared

Headers

x-api-keystring nullable

Request body

chart_textstring required

Operative note or encounter documentation. ⚠ PHI.

practice_settingstring
dosstring date nullable

Date of service

prior_proceduresobject[]
patient_ageinteger nullable
patient_sexstring nullable
em_familystring nullable

Level the visit's E/M too, e.g. 'office_established'. ⚠ Required from you rather than inferred — new-vs-established and office-vs-hospital are facts about the encounter a note frequently does not state. Adds one LLM call.

versioninteger nullable
payer_type'medicare_ffs' | 'medicare_advantage' | 'medicaid' | 'commercial' nullable

Who pays. Optional. Known: Medicare's dispositions are enforced for medicare_ffs (PFS N/B and HCPCS coverage I/M/S become blocking errors); for medicare_advantage Medicare's coding and coverage are stated as warnings, because the plan's own billing instructions decide; for medicaid/commercial a Medicare status is stated but never generalised. Absent: the payer is unresolved: every Medicare disposition is a warning that says so, and a line whose code depends on the payer is flagged, not billed as sent.

payer_statestring nullable

Two-letter state of the Medicaid programme. Only with payer_type=medicaid.

diagnosesstring[] nullable

The claim's Box 21 diagnoses, ICD-10-CM, lettered A-L in this order. Optional. Codes are checked as billable for the fiscal year of the date of service. Pointers are CHART-LINKED ONLY: a line points at a diagnosis only where the chart explicitly ties that service to it (quoted verbatim), otherwise the line carries the review item 'dx pointer not documented' — never a default.

Response

Successful Response

object required

Changes

No recorded changes to this operation across all 1 revision of this API.