API/Create Coding

Create Coding

Creates a new coding analysis request from medical conversation text

curl --request POST \
  --url https://api.sully.ai/v1/codings \
  --header 'Content-Type: application/json' \
  --header 'X-ACCOUNT-ID: <api-key>' \
  --header 'X-API-KEY: <api-key>' \
  --data '{
  "text": "[0:00] Doctor: Hi John, good to see you again. How'\''ve you been holding up?\nPatient: Hey doc. It'\''s been alright, but I'\''ve been feeling kind of off the last few weeks."
}'

200400Copy

{
  "data": {
    "id": "coding_EXAMPLE123456789",
    "status": "pending",
    "created_at": "2025-05-08T15:07:54.984Z",
    "updated_at": "2025-05-08T15:07:54.984Z"
  }
}

Authorizations

​X-API-KEYstringheaderrequired​X-ACCOUNT-IDstringheaderrequired

Body

application/json

Text content to analyze for medical coding

​textstringrequired

Transcript text of the medical conversation to analyze

Example:

"[0:00] Doctor: Hi John, good to see you again. How've you been holding up?\nPatient: Hey doc. It's been alright, but I've been feeling kind of off the last few weeks."

Response

204 application/json

Coding analysis request created

Response containing the initial status of a newly created coding analysis request

​data object

Data object containing the coding analysis metadata

Test the API here: https://docs.sully.ai/api-reference/codings/get

Hide child attributes

​data.idstring

Unique identifier for the coding analysis request

Example:

"coding_EXAMPLE123456789"

​data.statusenum<string>

Status of the coding analysis request

Available options:pending,processing,complete,failedExample:

"pending"

​data.created_atstring

Timestamp when the request was created

Example:

"2025-05-08T15:07:54.984Z"

​data.updated_atstring

Timestamp when the request was last updated

Example:

"2025-05-08T15:07:54.984Z"