How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

EHRbase Sandbox (live springdoc api-docs)

The OpenAPI document served by vitagroup's public EHRbase sandbox instance at sandkiste.ehrbase.org, harvested from /ehrbase/v3/api-docs. Combines the openEHR, EHR-Scape (ECIS), Admin and Status surfaces of the running server — 44 paths / 63 operations — and is the only vitagroup-published spec that carries a real, resolvable servers[] host rather than the generated localhost placeholder.

EHRbase Sandbox (live springdoc api-docs) is one of 5 APIs that vitagroup publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include openEHR, Sandbox, and Electronic Health Records. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 63 operations across 44 paths, organized into 20 resource areas, and defines 77 schemas. It is described by OpenAPI 3.1.0, at version v1.

Requests are made against a single base URL, https://sandkiste.ehrbase.org/ehrbase.

63 operations 44 paths 77 schemas 10 DELETE33 GET10 POST10 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
v1
Base URL
https://sandkiste.ehrbase.org/ehrbase
License
Resource Areas
20

Paths & Operations 63

Across 44 paths, the API surfaces 63 operations — 10 DELETE, 33 GET, 10 POST, 10 PUT. They span 20 resource areas, including EHR, EHR_STATUS, DIRECTORY, COMPOSITION, STORED_QUERY, Admin - Template, Admin - EHR, Admin - Contribution, and 12 more. Each is listed below with its method, path, parameters, and response codes.

EHR 4
GET
/rest/openehr/v1/ehr/{ehr_id}
Get EHR by id
getEhrById 1 param → 200404
PUT
/rest/openehr/v1/ehr/{ehr_id}
Create EHR with id
createEhrWithId 4 params body → 201400409
GET
/rest/openehr/v1/ehr
Get EHR summary by subject id and namespace
getEhrBySubject 2 params → 200404
POST
/rest/openehr/v1/ehr
Create EHR
createEhr 3 params body → 201400409
EHR_STATUS 3
GET
/rest/openehr/v1/ehr/{ehr_id}/ehr_status
Get EHRSTATUS version by time
getEhrStatusVersionByTime 2 params → 200400404
PUT
/rest/openehr/v1/ehr/{ehr_id}/ehr_status
Update EHRSTATUS
updateEhrStatus 3 params body → 200204400404412
GET
/rest/openehr/v1/ehr/{ehr_id}/ehr_status/{version_uid}
Get EHRSTATUS by version id
getEhrStatusByVersionId 2 params → 200404
DIRECTORY 5
GET
/rest/openehr/v1/ehr/{ehr_id}/directory
Get folder in directory version at time
getFolderInDirectoryVersionAtTime 4 params → 200204404
PUT
/rest/openehr/v1/ehr/{ehr_id}/directory
Update directory
updateDirectory 7 params body → 200204400404412
POST
/rest/openehr/v1/ehr/{ehr_id}/directory
Create directory
createDirectory 6 params body → 201400404
DELETE
/rest/openehr/v1/ehr/{ehr_id}/directory
Delete directory
deleteDirectory 5 params → 204400404412
GET
/rest/openehr/v1/ehr/{ehr_id}/directory/{version_uid}
Get folder in directory version
getFolderInDirectory 4 params → 200404
COMPOSITION 8
GET
/rest/openehr/v1/ehr/{ehr_id}/composition/{versioned_object_uid}
Get composition at time
getComposition 5 params → 200
PUT
/rest/openehr/v1/ehr/{ehr_id}/composition/{versioned_object_uid}
Update composition
updateComposition 10 params body → 200
GET
/rest/ecis/v1/composition/{uid}deprecated
Deprecated since 2.0.0 and marked for removal
getComposition_1 2 params → 200
PUT
/rest/ecis/v1/composition/{uid}deprecated
Deprecated since 2.0.0 and marked for removal
update 3 params body → 200
DELETE
/rest/ecis/v1/composition/{uid}deprecated
Deprecated since 2.0.0 and marked for removal
delete 1 param → 200
POST
/rest/openehr/v1/ehr/{ehr_id}/composition
Create composition
createComposition 8 params body → 201
POST
/rest/ecis/v1/compositiondeprecated
Deprecated since 2.0.0 and marked for removal
createComposition_1 3 params body → 200
DELETE
/rest/openehr/v1/ehr/{ehr_id}/composition/{preceding_version_uid}
Delete composition
deleteComposition 4 params → 204
STORED_QUERY 5
GET
/rest/openehr/v1/definition/query/{qualified_query_name}/{version}
Get stored query and info/metadata
getStoredQueryVersion 3 params → 200
PUT
/rest/openehr/v1/definition/query/{qualified_query_name}/{version}
Store a query
putStoredQuery 5 params body → 200
GET
/rest/openehr/v1/definition/query/{qualified_query_name}
List stored queries
getStoredQueryList 2 params → 200
PUT
/rest/openehr/v1/definition/query/{qualified_query_name}
Store a query
putStoredQuery_1 4 params body → 200
GET
/rest/openehr/v1/definition/query
List stored queries
getStoredQueryList_1 1 param → 200
Admin - Template 3
PUT
/rest/admin/template/{template_id}
updateTemplate 3 params body → 200401403404422
DELETE
/rest/admin/template/{template_id}
deleteTemplate 1 param → 202401403404422
DELETE
/rest/admin/template/all
deleteAllTemplates → 200401403404422
Admin - EHR 2
PUT
/rest/admin/ehr/{ehr_id}
updateEhr 2 params → 200401403404
DELETE
/rest/admin/ehr/{ehr_id}
deleteEhr 1 param → 204401403404
Admin - Contribution 2
PUT
/rest/admin/ehr/{ehr_id}/contribution/{contribution_id}
updateContribution 2 params → 200401403404
DELETE
/rest/admin/ehr/{ehr_id}/contribution/{contribution_id}
Not supported since 2.0.0
deleteContribution 2 params → 501
QUERY 6
GET
/rest/openehr/v1/query/{qualified_query_name}/{version}
Execute stored query
executeStoredQuery 5 params → 200
POST
/rest/openehr/v1/query/{qualified_query_name}/{version}
Execute stored query
executeStoredQuery_1 4 params body → 200
GET
/rest/openehr/v1/query/{qualified_query_name}
Execute stored query
executeStoredQuery_2 4 params → 200
POST
/rest/openehr/v1/query/{qualified_query_name}
Execute stored query
executeStoredQuery_3 3 params body → 200
GET
/rest/openehr/v1/query/aql
Execute ad-hoc (non-stored) AQL query
executeAdHocQuery 4 params → 200
POST
/rest/openehr/v1/query/aql
Execute ad-hoc (non-stored) AQL query
executeAdHocQuery_1 2 params body → 200
CONTRIBUTION 2
POST
/rest/openehr/v1/ehr/{ehr_id}/contribution
Create contribution
createContribution 6 params body → 201
GET
/rest/openehr/v1/ehr/{ehr_id}/contribution/{contribution_uid}
Get contribution by id
getContribution 5 params → 200
ADL 2 TEMPLATE 3
GET
/rest/openehr/v1/definition/template/adl2
List templates
getTemplatesNew 1 param → 200
POST
/rest/openehr/v1/definition/template/adl2
Upload a template
createTemplateNew 4 params body → 201
GET
/rest/openehr/v1/definition/template/adl2/{template_id}/{version_pattern}
Get template
getTemplateNew 3 params → 200
ADL 1.4 TEMPLATE 4
GET
/rest/openehr/v1/definition/template/adl1.4
List templates
getTemplatesClassic 1 param → 200
POST
/rest/openehr/v1/definition/template/adl1.4
Upload a template
createTemplateClassic 1 param body → 201
GET
/rest/openehr/v1/definition/template/adl1.4/{template_id}
Get template
getTemplateClassic 2 params → 200
GET
/rest/openehr/v1/definition/template/adl1.4/{template_id}/example
Get an example composition for the specified template
getTemplateExample 3 params → 200
Status 1

Heartbeat, Version info, Status

GET
/rest/status
Get status information on running EHRbase server instance
getEhrbaseStatus 1 param → 200
VERSIONED_EHR_STATUS 4
GET
/rest/openehr/v1/ehr/{ehr_id}/versioned_ehr_status
Get versioned EHRSTATUS
retrieveVersionedEhrStatusByEhr 1 param → 200
GET
/rest/openehr/v1/ehr/{ehr_id}/versioned_ehr_status/version
Get versioned EHRSTATUS version by time
retrieveVersionOfEhrStatusByTime 2 params → 200
GET
/rest/openehr/v1/ehr/{ehr_id}/versioned_ehr_status/version/{version_uid}
Get versioned EHRSTATUS version by id
retrieveVersionOfEhrStatusByVersionUid 2 params → 200
GET
/rest/openehr/v1/ehr/{ehr_id}/versioned_ehr_status/revision_history
Get versioned EHRSTATUS revision history
retrieveVersionedEhrStatusRevisionHistoryByEhr 1 param → 200
VERSIONED_COMPOSITION 4
GET
/rest/openehr/v1/ehr/{ehr_id}/versioned_composition/{versioned_object_uid}
Get versioned composition
retrieveVersionedCompositionByVersionedObjectUid 3 params → 200
GET
/rest/openehr/v1/ehr/{ehr_id}/versioned_composition/{versioned_object_uid}/version
Get versioned composition version at time
retrieveVersionOfCompositionByTime 4 params → 200
GET
/rest/openehr/v1/ehr/{ehr_id}/versioned_composition/{versioned_object_uid}/version/{version_uid}
Get versioned composition version by id
retrieveVersionOfCompositionByVersionUid 4 params → 200
GET
/rest/openehr/v1/ehr/{ehr_id}/versioned_composition/{versioned_object_uid}/revision_history
Get versioned composition revision history
retrieveVersionedCompositionRevisionHistoryByEhr 3 params → 200
TEMPLATE 3
GET
/rest/openehr/v1/definition/template/adl1.4/{template_id}/webtemplatedeprecated
Deprecated since 2.2.0 and marked for removal
getWebTemplate 2 params → 200
GET
/rest/ecis/v1/template/{templateId}deprecated
Deprecated since 2.0.0 and marked for removal
getTemplate 1 param → 200
GET
/rest/ecis/v1/template/{templateId}/exampledeprecated
Deprecated since 2.0.0 and marked for removal
getTemplateExample_1 2 params → 200
Admin - Heartbeat 1
GET
/rest/admin/status
getStatus → 200401403
Admin - Stored-Query 1
DELETE
/rest/admin/query/{qualified_query_name}/{version}
deleteStoredQuery 3 params → 200401403404
Admin - Directory 1
DELETE
/rest/admin/ehr/{ehr_id}/directory/{directory_id}
deleteDirectory_1 2 params → 200401403404
Admin - Composition 1
DELETE
/rest/admin/ehr/{ehr_id}/composition/{composition_id}
deleteComposition_1 2 params → 200401403404

Schemas 77

The contract defines 77 schemas that model the data the API accepts and returns. The most detailed are WebTemplateNode (18 properties), ArchetypeID (16 properties), Composition (13 properties), OriginalVersionComposition (11 properties). Each schema is shown below with its type and property counts.

ArchetypeID
object
16 properties
Archetyped
null
3 properties
CodePhrase
null
3 properties
DvCodedText
null
6 properties
DvDateTime
null
6 properties
DvDuration
null
7 properties
DvEHRURI
object
1 property
DvEncapsulated
null
2 properties
DvIdentifier
object
4 properties
DvIntervalDvDateTime
null
6 properties
DvIntervalDvDuration
null
6 properties
DvText
object
6 properties
DvURI
null
1 property
EhrStatus
object
11 properties
FeederAudit
null
5 properties
FeederAuditDetails
null
7 properties
Item
object
7 properties
ItemStructure
null
8 properties
Link
object
3 properties
ObjectId
object
1 property
PartyIdentified
null
3 properties
PartyProxy
null
1 property
PartyRef
null
3 properties
PartySelf
object
1 property
ReferenceRangeDvDateTime
object
2 properties
ReferenceRangeDvDuration
object
2 properties
TemplateId
null
1 property
TermMapping
object
3 properties
TerminologyId
object
1 property
UIDBasedId
null
1 property
Ehr
object
9 properties
HierObjectId
object
1 property
ObjectRefObjectId
object
3 properties
ObjectVersionId
object
1 property
Folder
object
10 properties
QueryDefinitionResponseData
object
5 properties
ActionRestResponseData
object
2 properties
Meta
object
3 properties
RestHref
object
1 property
AdminUpdateResponseData
object
1 property
MetaData
object
6 properties
QueryResponseData
object
5 properties
Attestation
object
10 properties
AuditDetails
object
5 properties
CONTRIBUTION
object
3 properties
DvMultimedia
null
11 properties
OriginalVersionRMObject
object
11 properties
RMObject
null
Contribution
object
3 properties
TemplateResponseData
CompositionWriteRestResponseData
object
3 properties
StatusResponseData
object
6 properties
VersionedEhrStatus
object
3 properties
OriginalVersionEhrStatus
object
11 properties
RevisionHistory
object
1 property
RevisionHistoryItem
object
2 properties
VERSIONED_COMPOSITION
object
4 properties
Composition
null
13 properties
ContentItem
object
7 properties
EventContext
null
9 properties
OriginalVersionComposition
object
11 properties
Participation
object
4 properties
PathSegment
object
4 properties
TemplateMetaDataDto
object
4 properties
WebTemplate
object
5 properties
WebTemplateAnnotation
object
2 properties
WebTemplateInput
object
7 properties
WebTemplateInputValue
object
8 properties
WebTemplateInterval
object
4 properties
WebTemplateNode
object
18 properties
WebTemplateTerminology
object
2 properties
WebTemplateValidation
object
3 properties
WebtemplateCardinality
object
4 properties
CompositionResponseData
object
7 properties
StructuredString
object
2 properties
AdminStatusResponseData
object
1 property
AdminDeleteResponseData
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

vitagroup-ehrbase-sandbox-live.json Raw ↑

Other APIs vitagroup publishes across the network.

HIP EHRbase openEHR REST API
HIP EHRbase Admin API
HIP EHRbase Item Tag Experimental API
HIP EHRbase Enterprise API
Where this information came from

This is an independent, third-party profile of EHRbase Sandbox (live springdoc api-docs), published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.