{"info":{"title":"HANK AutoCoder API","version":"1.0.0","description":"Autonomous medical coding over an API. Submit a clinical note and receive assigned CPT/ICD-10 codes with modifiers."},"paths":{"/v1/code":{"post":{"summary":"Code a clinical note","security":[{"bearerAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CodeResponse"}}},"description":"Codes assigned successfully."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid bearer token."}},"description":"Assign CPT and ICD-10 codes to a clinical note. The note is processed autonomously and the assigned codes are returned with modifiers.","operationId":"codeNote","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CodeRequest"}}},"required":true}}},"/v1/jobs/{jobId}":{"get":{"summary":"Get a coding job","security":[{"bearerAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Job"}}},"description":"The coding job."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"No job with that id."}},"parameters":[{"in":"path","name":"jobId","schema":{"type":"string"},"required":true,"description":"The coding job identifier."}],"description":"Fetch the status and result of a previously submitted coding job.","operationId":"getJob"}}},"openapi":"3.1.0","servers":[{"url":"https://api.hank.ai","description":"Production"}],"security":[{"bearerAuth":[]}],"components":{"schemas":{"Job":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string","example":"job_8f2c91"},"result":{"$ref":"#/components/schemas/CodeResponse"},"status":{"enum":["queued","running","done","failed"],"type":"string","example":"done"}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string","example":"unauthorized"},"message":{"type":"string","example":"Missing or invalid bearer token."}}},"CodeRequest":{"type":"object","required":["note"],"properties":{"meta":{"type":"object","properties":{"squashIcd":{"type":"boolean","default":false,"description":"Collapse redundant ICD-10 codes."}},"description":"Coding options."},"note":{"type":"string","example":"65F, type 2 diabetes, office visit, foot exam performed.","description":"The clinical documentation to code."},"schedule":{"type":"object","properties":{"date":{"type":"string","format":"date","example":"2026-06-17"}},"description":"Encounter scheduling context."}}},"AssignedCode":{"type":"object","required":["cpt"],"properties":{"cpt":{"type":"string","example":"99213"},"icd10":{"type":"array","items":{"type":"string"},"example":["E11.9"]},"modifiers":{"type":"array","items":{"type":"string"},"example":["25"]}}},"CodeResponse":{"type":"object","required":["success","codes"],"properties":{"codes":{"type":"array","items":{"$ref":"#/components/schemas/AssignedCode"}},"success":{"type":"boolean","example":true},"tokenUsage":{"type":"integer","example":1840}}}},"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"A bearer token issued by the Hank Codes console."}}}}