Skip to content
Get started

Clinical References

Create a clinical reference
ClinicalReference autoScribe().clinicalReferences().create(ClinicalReferenceCreateParamsparams, RequestOptionsrequestOptions = RequestOptions.none())
POST/v1/autoScribe/clinicalReferences
List clinical references
ClinicalReferenceListPage autoScribe().clinicalReferences().list(ClinicalReferenceListParamsparams = ClinicalReferenceListParams.none(), RequestOptionsrequestOptions = RequestOptions.none())
GET/v1/autoScribe/clinicalReferences
Retrieve a clinical reference by ID
ClinicalReference autoScribe().clinicalReferences().retrieve(ClinicalReferenceRetrieveParamsparams = ClinicalReferenceRetrieveParams.none(), RequestOptionsrequestOptions = RequestOptions.none())
GET/v1/autoScribe/clinicalReferences/{clinicalReferenceId}
Retrieve a clinical reference by external reference ID
ClinicalReference autoScribe().clinicalReferences().retrieveByExternalReferenceId(ClinicalReferenceRetrieveByExternalReferenceIdParamsparams = ClinicalReferenceRetrieveByExternalReferenceIdParams.none(), RequestOptionsrequestOptions = RequestOptions.none())
GET/v1/autoScribe/clinicalReferences/byExternalReferenceId/{externalReferenceId}
Update a clinical reference
ClinicalReference autoScribe().clinicalReferences().update(ClinicalReferenceUpdateParamsparams = ClinicalReferenceUpdateParams.none(), RequestOptionsrequestOptions = RequestOptions.none())
PATCH/v1/autoScribe/clinicalReferences/{clinicalReferenceId}
Delete a clinical reference
ClinicalReference autoScribe().clinicalReferences().delete(ClinicalReferenceDeleteParamsparams = ClinicalReferenceDeleteParams.none(), RequestOptionsrequestOptions = RequestOptions.none())
POST/v1/autoScribe/clinicalReferences/{clinicalReferenceId}/delete
ModelsExpand Collapse
class ClinicalReference:

A canonical clinical reference value for study workflow pickers and normalization

String clinicalReferenceId

Unique clinical reference identifier. Format: ref_{32-hex-chars}

Optional<LocalDateTime> createdAt

Timestamp when the clinical reference was created

formatdate-time
boolean isActive

Whether this reference is active and available for pickers

String name

Canonical display name for this reference value

minLength1

Category of canonical clinical reference value used for study workflow pickers and normalization.

One of the following:
FACILITY("facility")
REFERRING_PROVIDER("referring_provider")
STUDY_DESCRIPTION("study_description")
PROCEDURE("procedure")
Optional<LocalDateTime> updatedAt

Timestamp when the clinical reference was last updated

formatdate-time
Optional<ExpressCustomerReference> expressCustomer

A reference to an Express customer with basic identifying information

String expressCustomerId

Unique Express customer identifier. Format: cus_{32-hex-chars}

String expressCustomerName

Name of the Express customer

minLength1
Optional<String> externalReferenceId

Integrator-provided stable identifier for mapping inbound data

Optional<Metadata> metadata

Optional key-value metadata. Maximum 50 pairs