# HANK AI Documentation

> Guides, API references, and release notes for the HANK AI product suite — autonomous medical coding and revenue-cycle automation. Every page is available as raw markdown at its `/index.md` URL.

## Programmatic access

- [Ask AI](https://docs.hank.ai/api/ask): `POST` a JSON `{ "question": "…" }` to get an answer grounded in the public docs, returned with citations.
- [MCP server](https://docs.hank.ai/mcp): a JSON-RPC Model Context Protocol endpoint. Read tools — `list_docs` (the slug tree), `search_docs`, `get_page`, `get_section`, `list_changelog`, `list_api_specs`/`get_openapi` — let an agent discover slugs and ground itself in the live docs; with a scoped identity, `upsert_topic` publishes a topic.
- [Docs structure (JSON)](https://docs.hank.ai/api/structure): the full public product → manual → topic tree (slugs + titles) — discover real slugs before fetching a page.
- [Full corpus](https://docs.hank.ai/llms-full.txt): every public page concatenated as raw markdown — the whole corpus in one fetch for grounding.
- [Changelog feed (all products)](https://docs.hank.ai/changelog/rss.xml): a single global RSS feed of release notes across every product, newest first; the same feed as JSON at https://docs.hank.ai/api/changelog (omit `product` for the global feed, or pass `?product=<slug>` for one product).
- [Glossary](https://docs.hank.ai/glossary): plain-language definitions of the domain jargon and acronyms used across the docs; the same dictionary as JSON at https://docs.hank.ai/api/glossary (omit `product` for the global terms, or pass `?product=<slug>` to also include a product's scoped vocabulary).
- [Content API spec (OpenAPI 3.1)](https://docs.hank.ai/api/openapi.json): the self-describing, machine-readable contract for the PUBLIC content surfaces above — `/api/structure`, `/api/search`, `/api/section`, `/api/changelog`, `/api/glossary`, and `POST /api/ask` — with query params, status codes, and response shapes (for codegen and agent tooling). No auth required for any of them.
- [REST API](https://docs.hank.ai/api/v1): a bearer-token REST API (`Authorization: Bearer <token>`, `hank-docs` scope). `POST https://docs.hank.ai/api/v1/topics/upsert` is the pipeline-gated, idempotent programmatic publish path (key on a stable `sourceKey`).
- [OpenAPI 3.1 spec](https://docs.hank.ai/api/v1/openapi.json): the self-describing, machine-readable contract for the entire REST API above (for codegen) — browse it at [https://docs.hank.ai/developers/api](https://docs.hank.ai/developers/api).
- [API quickstart](https://docs.hank.ai/developers/getting-started): new integrators start here — get a token, make the first REST call, publish a topic, handle the error codes, respect rate limits, and call the MCP server.
- [Agent integration guide](https://docs.hank.ai/developers/agents): the orchestration recipe for an autonomous agent — chain these surfaces into a discover → search → retrieve → ground → cite loop, and publish idempotently back through review.
- [Resource lifecycle guide](https://docs.hank.ai/developers/guides/crud): the full resource-management lifecycle over the REST API — the products → manuals → chapters → topics hierarchy, create/list/filter, the metadata-only update seam, idempotent content publishing, and deletes.
- [API error reference](https://docs.hank.ai/developers/errors): the catalog of HTTP status codes and error codes the REST API returns — what each means and how a client should handle it.
- [Connect a publisher](https://docs.hank.ai/hank-codes/getting-started/connect-a-publisher/index.md): the getting-started guide for publishing documentation over the API or MCP.

## Trust & compliance

- [Trust & data practices](https://docs.hank.ai/trust): how this documentation platform handles analytics, feedback, free text, AI assistance, and content review — described against what the platform technically does, verifiable in the source.
- [Report a security issue](https://docs.hank.ai/trust#report): responsible-disclosure channel for this documentation site; also machine-readable at https://docs.hank.ai/.well-known/security.txt (RFC 9116).
- [Compliance](https://docs.hank.ai/compliance): an index of the compliance-review surfaces — data practices, security disclosure, the tamper-evident audit trail, and content-review governance.

## [HANK Claim Maker](https://docs.hank.ai/hank-claim-maker)

Build clean claims, fast.

- [Adding and Managing Custom User Roles](https://docs.hank.ai/hank-claim-maker/guide/custom-roles/index.md)
- [Admin View Layout](https://docs.hank.ai/hank-claim-maker/guide/admin-view-layout/index.md)
- [Attach a Document to a Case](https://docs.hank.ai/hank-claim-maker/guide/attach-document-to-a-case/index.md)
- [Claim Maker Export Options](https://docs.hank.ai/hank-claim-maker/guide/export-options/index.md)
- [Claim Maker LITE](https://docs.hank.ai/hank-claim-maker/guide/claim-maker-lite/index.md)
- [Claim Maker Overview](https://docs.hank.ai/hank-claim-maker/guide/overview/index.md): Turn clinical documentation into submission-ready claims.
- [Coding Cases in Hank Claim Maker](https://docs.hank.ai/hank-claim-maker/guide/coding-cases-in-hank-claim-maker/index.md)
- [Create New Batch \(If needed\)](https://docs.hank.ai/hank-claim-maker/guide/create-new-batch/index.md)
- [Data Entry](https://docs.hank.ai/hank-claim-maker/guide/data-entry/index.md)
- [Decoding Claim Maker Alert Emails](https://docs.hank.ai/hank-claim-maker/guide/decoding-claim-maker-alert-emails/index.md): Understand the daily batch and document update emails from claim-maker-alerts@hank.ai.
- [Schedule Reconciliation](https://docs.hank.ai/hank-claim-maker/guide/schedule-reconciliation/index.md)
- [Admin Role – Updating ASA Crosswalk](https://docs.hank.ai/hank-claim-maker/guide/admin-role-updating-asa-crosswalk/index.md)
- [Claim Maker Exports Explained](https://docs.hank.ai/hank-claim-maker/guide/claim-maker-exports-explained/index.md)
- [Claim Maker LITE Self Service Workflow](https://docs.hank.ai/hank-claim-maker/guide/claim-maker-lite-self-service/index.md)
- [Coder View Layout](https://docs.hank.ai/hank-claim-maker/guide/coder-view-layout/index.md)
- [Coding Line Items](https://docs.hank.ai/hank-claim-maker/guide/coding-line-items/index.md)
- [Create New Case](https://docs.hank.ai/hank-claim-maker/guide/create-new-case/index.md)
- [Data Entry Fields](https://docs.hank.ai/hank-claim-maker/guide/data-entry-fields/index.md)
- [Event Descriptions and Recommended User Responses](https://docs.hank.ai/hank-claim-maker/guide/user-response/index.md)
- [Getting Started with Claim Maker](https://docs.hank.ai/hank-claim-maker/guide/getting-started/index.md)
- [Manually Uploading Documents for Processing](https://docs.hank.ai/hank-claim-maker/guide/manually-uploading-documents-for-processing/index.md)
- [Reconcile View Layout](https://docs.hank.ai/hank-claim-maker/guide/reconcile-view-layout/index.md)
- [Admin Role – Managing Users and Access and More!](https://docs.hank.ai/hank-claim-maker/guide/managing-users-and-access/index.md)
- [Assigning Batches and Cases](https://docs.hank.ai/hank-claim-maker/guide/assigning-batches-and-cases/index.md)
- [Best Practices for File Uploads](https://docs.hank.ai/hank-claim-maker/guide/best-practices-for-file-uploads/index.md)
- [Claim Maker JSON Export Specification](https://docs.hank.ai/hank-claim-maker/guide/claim-maker-json-export-specification/index.md)
- [Creating Batches and Cases in CM LITE](https://docs.hank.ai/hank-claim-maker/guide/creating-batches-and-cases-in-cm-lite/index.md)
- [Data Entry Required Fields](https://docs.hank.ai/hank-claim-maker/guide/data-entry-required-fields/index.md)
- [Data Entry View Layout](https://docs.hank.ai/hank-claim-maker/guide/data-entry-view-layout/index.md)
- [First Time User Access Instructions](https://docs.hank.ai/hank-claim-maker/guide/first-time-user-access-instructions/index.md)
- [Line Item Validation](https://docs.hank.ai/hank-claim-maker/guide/line-item-validation/index.md): Check your coding before export with the Validation tab in Claim Maker.
- [Updated System Responses for Common Scenarios](https://docs.hank.ai/hank-claim-maker/guide/updated-system-responses-for-common-scenarios/index.md)
- [Adding a New Facility for Claim Maker LITE](https://docs.hank.ai/hank-claim-maker/guide/adding-a-new-facility-for-claim-maker-lite/index.md)
- [CSV Billing Export Spec](https://docs.hank.ai/hank-claim-maker/guide/csv-billing-export-spec/index.md)
- [Field Formatting Reference](https://docs.hank.ai/hank-claim-maker/guide/field-formatting-reference/index.md)
- [Getting Connected to Claim Maker](https://docs.hank.ai/hank-claim-maker/guide/getting-connected-to-claim-maker/index.md)
- [Keyboard Shortcuts for Line Items](https://docs.hank.ai/hank-claim-maker/guide/keyboard-shortcuts/index.md)
- [Manage Facility and Role Access](https://docs.hank.ai/hank-claim-maker/guide/manage-facility-and-role-access/index.md)
- [Move Documents](https://docs.hank.ai/hank-claim-maker/guide/move-a-document/index.md)
- [Resizable Panels](https://docs.hank.ai/hank-claim-maker/guide/resizable-panels/index.md)
- [Update Batch State](https://docs.hank.ai/hank-claim-maker/guide/update-batch-state/index.md)
- [Automatic Address Population using Zipcode](https://docs.hank.ai/hank-claim-maker/guide/automatic-address-population-using-zipcode/index.md)
- [Dark Mode](https://docs.hank.ai/hank-claim-maker/guide/dark-mode/index.md)
- [Delete a Document](https://docs.hank.ai/hank-claim-maker/guide/delete-a-document/index.md)
- [JSON Billing Export Spec](https://docs.hank.ai/hank-claim-maker/guide/json-billing-export-spec/index.md)
- [Managing Provider and Surgeon NPIs](https://docs.hank.ai/hank-claim-maker/guide/managing-provider-and-surgeon-npis/index.md)
- [Support Information](https://docs.hank.ai/hank-claim-maker/guide/support-information/index.md)
- [Update Case State and Reason](https://docs.hank.ai/hank-claim-maker/guide/update-case-state-and-reason/index.md)
- [Validating Claims](https://docs.hank.ai/hank-claim-maker/guide/validating-claims/index.md): Catch errors before a claim leaves the building.
- [Autocoding 2.0](https://docs.hank.ai/hank-claim-maker/guide/autocoding-2-0/index.md): What Autocoding 2.0 is, the specialties it codes, its five review element types, and how to enable it.
- [Customize Batch and Case States](https://docs.hank.ai/hank-claim-maker/guide/customize-batch-and-case-states/index.md)
- [Exporting Batches for Billing](https://docs.hank.ai/hank-claim-maker/guide/exporting-batches-for-billing/index.md)
- [Provider NPI and Advanced Search](https://docs.hank.ai/hank-claim-maker/guide/provider-npi-and-advanced-search/index.md)
- [Saving Insurances with IDs](https://docs.hank.ai/hank-claim-maker/guide/saving-insurances-with-ids/index.md)
- [Split Pages from a Document](https://docs.hank.ai/hank-claim-maker/guide/split-a-document/index.md)
- [User Settings](https://docs.hank.ai/hank-claim-maker/guide/user-settings/index.md)
- [Autocoding Predictions](https://docs.hank.ai/hank-claim-maker/guide/autocoding-predictions/index.md): What codes Autocoding predicts, and how to review and apply predictions in Claim Maker.
- [Document Remediation](https://docs.hank.ai/hank-claim-maker/guide/document-remediation/index.md)
- [Filtering Batches and Cases](https://docs.hank.ai/hank-claim-maker/guide/filtering-batches-and-cases/index.md)
- [Removing Access to Claim Maker](https://docs.hank.ai/hank-claim-maker/guide/removing-access-to-claim-maker/index.md)
- [Human Review Elements \(Autocoding 2.0\)](https://docs.hank.ai/hank-claim-maker/guide/human-review-elements-autocoding-2-0/index.md): The five types of Human Review Elements, what each one means, and how to work them in Claim Maker.
- [Missing Documents](https://docs.hank.ai/hank-claim-maker/guide/missing-documents/index.md)
- [Saving Filter Sets](https://docs.hank.ai/hank-claim-maker/guide/saving-filter-sets/index.md)
- [Updating Facility Display Name](https://docs.hank.ai/hank-claim-maker/guide/updating-facility-display-name/index.md)
- [Adding Additional Times](https://docs.hank.ai/hank-claim-maker/guide/adding-additional-times/index.md)
- [Case Document Viewer](https://docs.hank.ai/hank-claim-maker/guide/case-document-viewer/index.md)
- [Move Case to Different Batch](https://docs.hank.ai/hank-claim-maker/guide/move-case-to-different-batch/index.md)
- [Updating ASA Crosswalks](https://docs.hank.ai/hank-claim-maker/guide/updating-asa-crosswalks/index.md)
- [Batch Documents and Notes](https://docs.hank.ai/hank-claim-maker/guide/batch-documents-and-notes/index.md)
- [Custom Fields](https://docs.hank.ai/hank-claim-maker/guide/custom-fields/index.md)
- [Delete a Batch](https://docs.hank.ai/hank-claim-maker/guide/delete-a-batch/index.md)
- [Audit Logs](https://docs.hank.ai/hank-claim-maker/guide/audit-logs/index.md)
- [Delete a Case](https://docs.hank.ai/hank-claim-maker/guide/delete-a-case/index.md)
- [Restore a Deleted Batch](https://docs.hank.ai/hank-claim-maker/guide/restore-a-deleted-batch/index.md)
- [Restore a Deleted Case inside a Batch](https://docs.hank.ai/hank-claim-maker/guide/restore-a-deleted-case-inside-a-batch/index.md)
- [Share Batch and Share Case Links](https://docs.hank.ai/hank-claim-maker/guide/share-batch-and-share-case-links/index.md)
- [Case Notes](https://docs.hank.ai/hank-claim-maker/guide/case-notes/index.md)
- [Claim Maker Work Queue](https://docs.hank.ai/hank-claim-maker/guide/claim-maker-work-queue/index.md)
- [Work Queue filtering](https://docs.hank.ai/hank-claim-maker/guide/work-queue-filtering/index.md)

### Release notes

- [Changelog](https://docs.hank.ai/hank-claim-maker/changelog): dated release notes for HANK Claim Maker.
- [Changelog API (JSON)](https://docs.hank.ai/api/changelog?product=hank-claim-maker): the machine-readable changelog feed.

## [HANK CODES](https://docs.hank.ai/hank-codes)

The autonomous medical coding platform.

- [Welcome to HANK CODES](https://docs.hank.ai/hank-codes/getting-started/welcome/index.md): The autonomous medical-coding platform, from clean claim data to autonomously assigned codes.
- [Quickstart](https://docs.hank.ai/hank-codes/getting-started/quickstart/index.md): Get from zero to your first coded claim in a few minutes.
- [Anesthesia Auto-Coding](https://docs.hank.ai/hank-codes/specialty-guides/anesthesia-auto-coding/index.md): How HANK CODES reads an anesthesia case, picks the ASA code, extracts times, and flags what a coder must confirm.
- [GI Endoscopy Anesthesia](https://docs.hank.ai/hank-codes/specialty-guides/gi-anesthesia-auto-coding/index.md): How the autocoder selects GI endoscopy anesthesia codes, combines upper and lower scopes into 00813, and explains each choice.
- [Obstetric Anesthesia](https://docs.hank.ai/hank-codes/specialty-guides/ob-anesthesia-auto-coding/index.md): How the autocoder codes labor epidurals, cesarean conversions, and other obstetric anesthesia services in the 01958-01969 range.
- [Nerve Block Coding](https://docs.hank.ai/hank-codes/specialty-guides/nerve-block-coding/index.md): How the autocoder decides when a nerve block bills separately, how it counts paravertebral units, and which diagnoses ride on the block line.
- [Post-Op Pain Rounds](https://docs.hank.ai/hank-codes/specialty-guides/post-op-pain-rounds/index.md): The autocoder codes an acute pain service round as the round, not as the surgery in the same record.
- [Radiology Auto-Coding](https://docs.hank.ai/hank-codes/specialty-guides/radiology-auto-coding/index.md): How the autocoder reads a radiology report and produces imaging CPT codes, modifiers, and ICD-10 diagnoses.
- [Interventional Radiology](https://docs.hank.ai/hank-codes/specialty-guides/interventional-radiology-auto-coding/index.md): The autocoder recognizes interventional radiology reports and codes them with IR-specific add-on and bundling checks.
- [Surgeon Companion Claims](https://docs.hank.ai/hank-codes/specialty-guides/surgeon-companion-claims/index.md): One run over the same documents can produce the surgeon professional-fee output next to the anesthesia claim.
- [E/M Office Visits](https://docs.hank.ai/hank-codes/specialty-guides/em-office-visit-coding/index.md): The autocoder quotes the evidence and a deterministic engine picks the office visit level 99202-99215.
- [E/M Hospital and ED Visits](https://docs.hank.ai/hank-codes/specialty-guides/em-hospital-ed-coding/index.md): The autocoder codes hospital inpatient, observation, and emergency department visits from evidence it quotes from the chart.
- [How Alerts Reach Your Workflow](https://docs.hank.ai/hank-codes/alerts-and-review/how-alerts-reach-your-workflow/index.md): Alerts are classifications. Your workflow decides what holds, queues, or releases a claim.
- [OB Case Review Alert](https://docs.hank.ai/hank-codes/alerts-and-review/ob-case-review/index.md): Every obstetric anesthesia case gets an OB case review alert so a coder confirms the unique OB billing rules.
- [Anesthesia Alert Reference](https://docs.hank.ai/hank-codes/alerts-and-review/anesthesia-alerts-reference/index.md): The anesthesia alerts a coder meets most often, grouped by topic, with the trigger and the check for each one.
- [E/M Alert Reference](https://docs.hank.ai/hank-codes/alerts-and-review/em-alerts-reference/index.md): The review alerts the autocoder raises on office, hospital, observation, and emergency department E/M visits.
- [Radiology Alert Reference](https://docs.hank.ai/hank-codes/alerts-and-review/radiology-alerts-reference/index.md): The radiology and interventional radiology review alerts a coder meets most often, with each alert id, type, and default severity.
- [Surgery Alert Reference](https://docs.hank.ai/hank-codes/alerts-and-review/surgery-alerts-reference/index.md): The alerts a coder meets on surgeon claims: source documents, cross-claim consistency, family coding rules, and payment-rule checks.
- [Where to See Your Reported Issues](https://docs.hank.ai/hank-codes/alerts-and-review/where-to-see-your-reported-issues/index.md): Track every coding issue your organization reported, and its delivery status, on the updates page.
- [Facility Configuration Guide](https://docs.hank.ai/hank-codes/configuration-guide/facility-configuration-guide/index.md): Every billing decision your facility can set in HANK CODES, with the default for each one.
- [Configuration Quick Reference](https://docs.hank.ai/hank-codes/configuration-guide/configuration-quick-reference/index.md): A one-page lookup of the HANK CODES configuration choices and their shipped defaults.
- [Medical Direction and Attestation](https://docs.hank.ai/hank-codes/configuration-guide/medical-direction-and-attestation/index.md): How the autocoder evaluates the documented attestation against the TEFRA requirements and turns the result into provider modifiers.
- [Tuning Review Alerts](https://docs.hank.ai/hank-codes/configuration-guide/tuning-review-alerts/index.md): Suppress, downgrade, or retune review alerts per facility, and understand what you give up.
- [ERAS Quality Measures](https://docs.hank.ai/hank-codes/configuration-guide/quality-measures-eras/index.md): Optional enhanced recovery quality measures the autocoder can score from the same record it codes.
- [Anesthesia Modifiers](https://docs.hank.ai/hank-codes/coding-reference/anesthesia-modifiers/index.md): The provider, MAC, and physical status modifiers the autocoder places on anesthesia lines, and what triggers each one.
- [Qualifying Circumstance Codes](https://docs.hank.ai/hank-codes/coding-reference/qualifying-circumstance-codes/index.md): How the autocoder codes 99100, 99116, 99135, and 99140, and why a Medicare claim moves them off the billable lines.
- [How Diagnoses Are Selected and Ranked](https://docs.hank.ai/hank-codes/coding-reference/diagnosis-coding/index.md): How the autocoder picks ICD-10 diagnoses, ranks them, and collapses documented pairs into combination codes.
- [How Coding Guidance Is Maintained](https://docs.hank.ai/hank-codes/coding-reference/how-coding-guidance-is-maintained/index.md): The coding knowledge behind the autocoder is authored from licensed sources, reviewed by coding experts, and updated as rules change.

### Release notes

- [Changelog](https://docs.hank.ai/hank-codes/changelog): dated release notes for HANK CODES.
- [Changelog API (JSON)](https://docs.hank.ai/api/changelog?product=hank-codes): the machine-readable changelog feed.

### Products on this platform

- [HANK AutoCoder API](https://docs.hank.ai/hank-autocoder-api)

## [HANK AutoCoder API](https://docs.hank.ai/hank-autocoder-api)

Part of [HANK CODES](https://docs.hank.ai/hank-codes).

Autonomous coding, over an API.

- [Authentication](https://docs.hank.ai/hank-autocoder-api/api-reference/authentication/index.md): How to authenticate requests to the AutoCoder API.
- [Security](https://docs.hank.ai/hank-autocoder-api/api-reference/security/index.md): How the AutoCoder API is secured: firewall, SSL, and a per-customer API key.
- [POST Requests](https://docs.hank.ai/hank-autocoder-api/api-reference/post-for-autocoding-requests/index.md): Submit a clinical note for autonomous coding — the async POST that returns a task id.
- [GET Request](https://docs.hank.ai/hank-autocoder-api/api-reference/get-request/index.md): Poll a submitted task until it completes, and read the predicted codes.

### API specification

- [OpenAPI spec (JSON)](https://docs.hank.ai/hank-autocoder-api/openapi.json): the raw OpenAPI document for HANK AutoCoder API.