Clinical Code Suggestions

POST /api/v1/codingThis endpoint provides normalized medical coding based on the provided assessment . It supports two coding formats: ICD-10 and SNOMED , determined by the codeType parameter. Optionally, the codeOnly parameter can be set to return only the medical code, excluding its textual definition. This endpoint helps standardize medical assessments by mapping them to normalized medical codes.HEADER PARAMETERS

REQUIREDX-Scrubs-Clinic-Codestring

Clinic code or identifier of the clinic making the API request.

REQUIREDX-Scrubs-Clinic-Providerstring

Provider ID associated with your EHR application.

REQUIREDX-Scrubs-<any-other-header>any

Other required headers depending on your organisation's provider ID.

BODY PARAMETERS

REQUIREDassessmentstring

A concise phrase or short sentence containing the clinician's assessment. Longer strings may affect medical code recommendations.

REQUIREDcodeTypestring, SNOMED | ICD-10

Specifies the medical coding format.

OPTIONALcodeOnlyboolean

Determines if only medical coding should be returned without textual definitions. Defaults to false.

Error Codes6 cases

Endpoint validation

400	Required coding input is missing.	assessment and codeType are required in the JSON body.
400	codeType is invalid.	codeType must be SNOMED or ICD-10.

Common HCI and authentication errors

400	Provider or HCI configuration is invalid.	Missing or unknown provider ID, no consultation method/auth flow configured for the provider, missing or malformed clinic code, invalid CA origin, or the provider clinic limit is reached.
401	Authentication failed.	API key credentials are missing or invalid, a root clinic/key cannot be found, or no API key is linked to the authenticated clinic.
429	Usage limit reached.	Free-tier usage is exhausted, or a non-root paid API key has expired.

Common runtime errors

500

Unexpected server or upstream failure.

Unhandled JSON/form parsing errors, AI provider failures, transcription provider failures, database errors, or unexpected response parsing failures.

Domain

BASE URL

1https://usescrubs.com

Sample Request

CURL

NodeJS

Python

CURL

1curl --location 'https://usescrubs.com/api/v1/coding' \
2--header 'X-Scrubs-Clinic-Code: 00A123' \
3--header 'X-Scrubs-Clinic-Provider: SAMPLE_EHR_1' \
4--header 'Content-Type: application/json' \
5--data '{
6    "assessment": "Functional dyspepsia",
7    "codeType": "SNOMED", 
8    "codeOnly": false
9}'

Sample Response

JSON

1{
2    "snomedCodes": [
3        {
4            "conceptId": "3696007",
5            "term": "Functional dyspepsia"
6        },
7        {
8            "conceptId": "87548005",
9            "term": "Dyspepsia (disorder)"
10        },
11        {
12            "conceptId": "155722007",
13            "term": "Dyspepsia, indigestion NOS"
14        }
15    ]
16}