POST Requests

The AutoCoder API is asynchronous. You submit a coding task with a POST, which returns a task id; you then poll for the result with a GET.

Endpoint

Request body

The request carries the document(s) to code under request.job.input.entities, plus optional patient, provider, and scheduling context.

{
  "Name": "some_blank_name",
  "request": {
    "service": "<reference to service>",
    "job": {
      "id": "value",
      "input": {
        "entities": [
          {
            "inputType": "text",
            "lastModifiedTime": "Mon Nov 02 12:56:49 EST 2020",
            "noteType": "SurgeonProcedureNote",
            "content": "Content representing type specified in inputType"

noteType

Each entity declares the kind of clinical note it carries via noteType. The accepted values are:

• SurgeonProcedureNote
• AnesthesiaProcedureNote
• AnesthesiaPreoperativeNote
• DiagnosisDescription
• SurgeryDescription
• AnesthesiaProcedureNote_AirwayPlacement
• AnesthesiaProcedureNote_LaborEpidural
• AnesthesiaProcedureNote_ArterialLine
• AnesthesiaProcedureNote_NerveBlock
• AnesthesiaProcedureNote_EpiduralCatheterNonOB
• AnesthesiaProcedureNote_CentralLine

schedule.surgeonNPI (optional)

In the schedule section there is an optional surgeonNPI field. If provided, it can further enhance the system’s ability to predict the correct codes.

meta.squash_icd

When squash_icd is true, the API returns the minimal set of ICD codes (used for billing claims, for example). When omitted or set to the default of false, the behavior is to return the maximal set of valid ICD codes (useful for audits, or anywhere the client wants them all available).

patient_info (guarantor, insurance, and patient demographics/addresses) and provider may also be supplied on the job. See the full schema in the embedded API reference on the Authentication page.

Response

A successful submission returns 200 OK with the task id to poll:

{
  "id": "<id>",
  "metadata": {
    "apiVersion": "1.0",
    "timeStamp": "timestamp",
    "apiKey": "apiKeyValue"
  }
}

Take the id and poll it via the GET Request.