The glossary below contains a list of main terms and their explanation.
| Term | Description |
|---|---|
| API key | Access token used to authenticate requests to Ornament APIs (retrieved from Ornament Pro → Account → Developer tools). |
| Biomarker | A biological characteristic that can be objectively measured, including the result of a specific medical test (e.g. glucose level, protein presence in blood plasma). |
| Biomarker category | Classification group for biomarkers, available via the Thesaurus API. |
| Biomaterial | Biological specimen or sample type associated with a biomarker measurement. |
| Custom reference range | Partner-defined reference ranges that may override default Ornament reference values. |
| Default unit | Canonical internal measurement unit used by Ornament for a biomarker. |
| Digitization | Process of converting uploaded medical documents into structured medical data. |
| Digitization completion event | Webhook event fired when processing finishes (e.g. NEW_SUBMISSION, REJECT_IMAGESET, SPLIT_IMAGESET). |
| File group | A logical unit inside a fileset representing one document package; must follow an allowed upload template (e.g. images, PDF, XML, JSON). |
| Fileset | A container linked to a profile for uploading documents for digitization; may contain one or more file groups. |
| IID (Imageset ID) | Unique identifier of an imageset used in digitization and webhook payloads. |
| Imageset | A set of images/files for which digitization is carried out. One imageset describes one laboratory test (e.g. complete blood count) or a complex of tests performed by one laboratory on one date. |
| Linked profile | A profile relationship concept used in the Accounting API to represent connected user profiles. |
| Measurement unit | Unit entity returned by the Thesaurus API describing how biomarker values are measured. |
| Original unit | Measurement unit from the source document associated with the original value. |
| Original value | Raw value as it appears in the source document before normalization. |
| PID (Profile ID) | Unique identifier of a user or patient profile used to retrieve medical data such as submissions and biomarkers. |
| Production environment | Live environment using production API base URLs intended for real integrations. |
| Recognition results | Structured data produced after digitization, including biomarkers, values, units, and reference ranges. |
| Reference values | Range of biomarker values considered normal or optimal; may vary depending on age, gender, chronic conditions, pregnancy, and other factors. |
| Sandbox environment | Testing environment using sandbox API base URLs; automatic digitization is disabled, but sample pre-digitized files are available. |
| SEID (Submission Entry ID) | Unique identifier of a single biomarker measurement entry within a submission. |
| SID (Submission ID) | Unique identifier of a submission created from an imageset. |
| Submission | In the Ornament system, a submission is a set of biomarkers and their values obtained as a result of digitizing an imageset. |
| Thesaurus API | Dictionary-style API providing standardized entities such as biomarkers, units, diseases, and biomaterials. |
| Webhook | HTTP callback sent to a partner endpoint to notify about digitization lifecycle events. |