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-HCI-Codestring
HCI code of the clinic making the API request.
REQUIREDX-Scrubs-HCI-Providerstring
Provider ID associated with your EHR application.
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.
Domain
BASE URL
1https://usescrubs.com
Sample Request
CURL
NodeJS
Python
Go
CURL
1curl --location 'https://usescrubs.com/api/v1/coding' \
2--header 'X-Scrubs-HCI-Code: 00A123' \
3--header 'X-Scrubs-HCI-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}
Contact us:hc@usescrubs.com