Generate ICD codes

Draws ICD-11 diagnosis codes from the visit’s note. Answers 202 with a job; poll GET /jobs/. The codes also appear on GET /visits/. Scope visits:write.

POST /visits/{id}/icd-codes

Generate ICD codes

cURL

curl --request POST \
  --url https://rxnote.ai/api/v1/visits/{id}/icd-codes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "clinician_email": "[e-mail]"
}
'

200

{
  "id": "job_4Rt8Vb1Np3Zs7Hc2kQ9xLm",
  "kind": "note",
  "visit_id": 123,
  "status": "queued",
  "created_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "error": {
    "code": "NOTE_FAILED",
    "message": "<string>"
  },
  "note": {
    "id": 5521,
    "visit_id": 123,
    "template": {
      "id": 123,
      "name": "<string>"
    },
    "framework": "<string>",
    "sections": [
      {
        "id": "<string>",
        "title": "<string>",
        "fields": [
          {
            "id": "<string>",
            "label": "<string>",
            "text": "<string>"
          }
        ]
      }
    ],
    "html": "<string>",
    "created_at": "2023-11-07T05:31:56Z"
  },
  "icd_codes": {
    "code_version": "icd11",
    "generated_at": "<string>",
    "codes": [
      {
        "code": "CA02",
        "name": "Acute pharyngitis",
        "confidence": "high"
      }
    ]
  }
}

Authorizations

Authorization · string · header · required

Your API key, created in RxNote under Settings → API: Authorization: Bearer rxn_live_….

Headers

Idempotency-Key · string · required

Your unique id for this request. Retrying with the same key returns the same job.

Required string length: 1 - 255

Example:

"letter-appt-0001"

Path Parameters

id · integer · required

Example:

90211

Body

application/json

clinician_email · string<email>

Required with an organization key: the RxNote member acting. With a personal key, omit it or send the owner's own email.

Maximum string length: 255

Example:

"[e-mail]"

Response

200

application/json

The job already created with this Idempotency-Key.

Work that runs after the request answers. Poll GET /jobs/{id} until completed or failed.

id · string · required

Example:

"job_4Rt8Vb1Np3Zs7Hc2kQ9xLm"

kind · enum<string> · required

Available options: note, icd_codes

visit_id · integer · required

status · enum<string> · required

Available options: queued, running, completed, failed

created_at · string<date-time> · required

completed_at · string<date-time> | null · required

error · object | null · required

Show child attributes

note · object | null

For a note job, once completed.

Show child attributes

icd_codes · object | null

For an icd_codes job, once completed.

Show child attributes