Evidence

POST /api/v1/evidenceReturns an evidence_map of key-value pairs. This endpoint requires both a transcript and a summary from a consultation. It extracts all independent points within the summary given and sources their references from the provided transcript . The evidence_map contains keys from the summary and values from the transcript .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

REQUIREDtranscriptstring

A consultation transcription. It does not need to follow the format of transcription endpoint.

REQUIREDsummarystring

A consultation summary. It does not need to follow the format of summaries from the summary endpoint but should resemble a SOAP note.

Error Codes5 cases

Endpoint validation

400

Transcript or summary is missing or invalid.

The JSON body must include non-empty transcript and summary values.

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/evidence' \
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    "transcript":"Hi, doctor, I have been having a headache for the past 1 week ...",
7    "summary":"Patient reports having a headache for the past week ..."
8}'

Sample Response

JSON

1{
2    "evidence_map": {
3       "Patient reports having a headache for the past week": "Headache since last Monday.",
4       "Unable to work due to persistent headache": "Haven't worked for the past week.",
5       "Patient reports poor sleep": "A bit of poor sleep for the last 2 to 3 nights.",
6        ...
7    }
8}