Skip to main content
POST
Add Diagnosis Codes
This is an asynchronous operation. The request returns a job_id immediately, and a webhook is sent when the operation completes. Codes already on the encounter are skipped, so re-sending a code is safe. Only ICD-10 diagnosis codes are supported today; CPT codes are not. Currently available on eClinicalWorks.
Each code is { "type": "icd10", "code": "..." }. The dot in a code is optional (E119 and E11.9 are equivalent). Send one or many codes in a single request.

Example Request

Example Response

Webhook

On completion we send a codes.added event (or codes.failed on error). icd reports which codes were applied versus skipped as duplicates, not matched in the EMR catalog, or rejected as invalid for the encounter date.
See Operation Events for the failure payload and error codes.

Authorizations

client_id
string
header
required
client_secret
string
header
required
access_token
string
header
required

Path Parameters

appointment_id
string
required

The Cobalt appointment ID.

Body

application/json
codes
object[]
required

Codes to add. Accepts one or many.

callback_urls
string[]

Optional per-request webhook URLs to notify on completion.

Response

Operation queued.

success
boolean
message
string
job_id
string

Job execution identifier for tracking the async operation.