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

EMIS Health Medical Record API

The medicalRecord API from EMIS Health — 12 operation(s) for medicalrecord.

EMIS Health Medical Record API is one of 12 APIs that EMIS Health publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and authentication docs.

This API exposes 12 operations across 12 paths, and defines 112 schemas. It is described by OpenAPI 3.2.0, at version 1.2.

Requests are made against the base URL https://api.platform.emis-x.uk/partner.

12 operations 12 paths 112 schemas 9 GET2 PATCH1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.2
Base URL
https://api.platform.emis-x.uk/partner
Authentication
HTTP Bearer, OAuth 2.0
Resource Areas
1

Authentication & Security 2

EMIS Health Medical Record API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (JWT) (bearer). It supports OAuth 2.0 (OAuth2CodeEMIS-X-GP-PAPI) using the authorizationCode flow, exposing 7 scopes.

Paths & Operations 12

Across 12 paths, the API surfaces 12 operations — 9 GET, 2 PATCH, 1 POST. Each is listed below with its method, path, parameters, and response codes.

medicalRecord 12
GET
/api/v1/medicalRecord/GetAttachments
This call returns an EMIS Open medical record message containing a list of attachments to that patient’s record. To retrieve the attachment data, call GetAttachments, parse the list of attachments fo…
GetAttachments 2 params → 500400401404415200
GET
/api/v1/medicalRecord/GetAttachmentsV2
This call returns an EMIS Open medical record message containing a list of attachments to that patient’s record. To retrieve the attachment data, call GetAttachments, parse the list of attachments fo…
GetAttachmentsV2 2 params → 500400401404415200
GET
/api/v1/medicalRecord/GetBase64AttachmentData
This function accepts a DDSIdentifier argument which uniquely identifies a specific attachment, even where attachments with duplicated names occur in the database. It returns the complete attached fi…
GetBase64AttachmentData 3 params → 500400401404415200
GET
/api/v1/medicalRecord/GetBase64AttachmentDataV2
V2: This function accepts a DDSIdentifier argument which uniquely identifies a specific attachment, even where attachments with duplicated names occur in the database. It returns the complete attache…
GetBase64AttachmentDataV2 3 params → 500400401404415200
GET
/api/v1/medicalRecord/GetCodedRecord
This call returns a subset of the medical record which comprises only of the clinically coded items. It does not return Medication or registration information.
GetCodedRecord 2 params → 500400401404415200
GET
/api/v1/medicalRecord/GetConsultation
This call returns a specific consultation record and any associated information. For instance, the location and users relating to the consultation content.
GetConsultation 3 params → 500400401404415200
GET
/api/v1/medicalRecord/GetEvents
This call returns a subset of the medical record which comprises only the coded clinical events for the patient. Information is returned for the specified time period counting back from the current d…
GetEvents 3 params → 500400401404415200
GET
/api/v1/medicalRecord/GetMedicalRecord
This call returns a medical record for a specific patient number. Before using this call please consider what information you require from the patient record and see if any of the other available cal…
GetMedicalRecord 2 params → 500400401404415200
GET
/api/v1/medicalRecord/GetMedicationIssues
This call returns a list of issued medication. This call will execute significantly faster than getMedicalRecord, particularly for patients with large medical records.
GetMedicationIssues 3 params → 500400401404415200
PATCH
/api/v1/medicalRecord/UpdateAttachment
This function updates the pfs visible and provisional status of a specified attachment
UpdateAttachment 5 params → 500400401404415204
PATCH
/api/v1/medicalRecord/UpdateConsultationVisibility
Updates the PFS Visibility value for a consultation previously filed into EMIS Web and all associated content (clinical code, associated text and attachments), including any linked observations.
UpdateConsultationVisibility 4 params → 500400401404415200
POST
/api/v1/medicalRecord/FileRecord
This call files a new consultation from an XML message, into a patient's medical record. Patient ID This is the DBID number of the patient. Attachments are referenced by the Attachment/Address elemen…
FileRecord 2 params body → 500400401404415204

Schemas 112

The contract defines 112 schemas that model the data the API accepts and returns. The most detailed are PartnerApi.EmisOpen.MedicalRecord38.RegistrationType (60 properties), PartnerApi.EmisOpen.MedicalRecord38.ReferralType (55 properties), PartnerApi.EmisOpen.MedicalRecord38.IssueType (54 properties), PartnerApi.EmisOpen.MedicalRecord38.PersonType (49 properties). Each schema is shown below with its type and property counts.

PartnerApi.EmisOpen.MedicalRecord38.PersonTypeScripts
integer
PartnerApi.EmisOpen.MedicalRecord38.RegistrationTypeDead
integer
PartnerApi.EmisOpen.MedicalRecord38.MedicalRecordTypeMessageInformationMessagingError
object
2 properties
PartnerApi.EmisOpen.MedicalRecord38.TestRequestHeaderTypePregnant
integer
PartnerApi.EmisOpen.MedicalRecord38.StringCodeType
object
7 properties
PartnerApi.EmisOpen.MedicalRecord38.OriginatorType
object
3 properties
PartnerApi.EmisOpen.MedicalRecord38.QualifierType
object
2 properties
PartnerApi.EmisOpen.MedicalRecord38.OriginatorTypeSystem
object
2 properties
PartnerApi.EmisOpen.MedicalRecord38.PathologyTestType
object
18 properties
PartnerApi.EmisOpen.MedicalRecord38.LinkType
object
2 properties
PartnerApi.EmisOpen.MedicalRecord38.PolicyListTypePolicyType
object
6 properties
PartnerApi.EmisOpen.MedicalRecord38.ReferralTypeRequestType
integer
PartnerApi.EmisOpen.MedicalRecord38.IntegerCodeType
object
7 properties
PartnerApi.EmisOpen.MedicalRecord38.AppointmentTypeSite
object
2 properties
PartnerApi.EmisOpen.MedicalRecord38.RegistrationStatusType
object
3 properties
PartnerApi.EmisOpen.MedicalRecord38.RoleType
object
8 properties
PartnerApi.EmisOpen.MedicalRecord38.EDIOrderTypeOrderCategory
integer
PartnerApi.EmisOpen.MedicalRecord38.NumericValueType
object
10 properties
PartnerApi.EmisOpen.MedicalRecord38.ReferralType
object
55 properties
PartnerApi.EmisOpen.MedicalRecord38.PersonCategoryType
object
9 properties
PartnerApi.EmisOpen.MedicalRecord38.EDIOrderType
object
13 properties
PartnerApi.EmisOpen.MedicalRecord38.MedicationType
object
45 properties
PartnerApi.EmisOpen.MedicalRecord38.TestRequestHeaderTypeInnoculationRisk
integer
PartnerApi.EmisOpen.MedicalRecord38.EDIComment
object
1 property
PartnerApi.EmisOpen.MedicalRecord38.ReferralTypeNHS
integer
PartnerApi.EmisOpen.MedicalRecord38.IdentType
object
5 properties
PartnerApi.EmisOpen.MedicalRecord38.ProblemType
object
17 properties
PartnerApi.EmisOpen.MedicalRecord38.ReferralTypeTransport
integer
PartnerApi.EmisOpen.MedicalRecord38.AllergyType
object
29 properties
PartnerApi.EmisOpen.MedicalRecord38.IssueType
object
54 properties
PartnerApi.Service.Contracts.UpdateConsultationVisibility.PfsVisibilityType
integer
PartnerApi.EmisOpen.MedicalRecord38.NoteType
object
16 properties
PartnerApi.EmisOpen.MedicalRecord38.PathologyReportTypeOriginalMessageDetails
object
6 properties
PartnerApi.EmisOpen.MedicalRecord38.EventType
object
37 properties
PartnerApi.EmisOpen.MedicalRecord38.TestRequestHeaderTypeNHS
integer
PartnerApi.EmisOpen.MedicalRecord38.StructuredIdentType
object
7 properties
PartnerApi.EmisOpen.Base64AttachmentDataV2.root
object
4 properties
PartnerApi.EmisOpen.MedicalRecord38.PathologyReportTypeOriginalRequestor
object
2 properties
PartnerApi.Service.Contracts.Attachment.PfsVisibilityType
integer
PartnerApi.EmisOpen.MedicalRecord38.DiaryType
object
30 properties
PartnerApi.EmisOpen.MedicalRecord38.ControlledDrugInfoType
object
12 properties
PartnerApi.EmisOpen.MedicalRecord38.ReferralTypeCommunity
integer
PartnerApi.EmisOpen.MedicalRecord38.ApplicationType
object
7 properties
PartnerApi.EmisOpen.MedicalRecord38.PersonTypeLocum
integer
PartnerApi.EmisOpen.MedicalRecord38.ReferralTypeUrgency
integer
PartnerApi.EmisOpen.MedicalRecord38.RegistrationType
object
60 properties
PartnerApi.EmisOpen.MedicalRecord38.PersonTypeDoctor
integer
PartnerApi.EmisOpen.MedicalRecord38.PathologySpecimenType
object
20 properties
PartnerApi.EmisOpen.MedicalRecord38.CarePlanType
object
7 properties
PartnerApi.EmisOpen.MedicalRecord38.MedicationTypeDrug
object
1 property
PartnerApi.EmisOpen.MedicalRecord38.MedicalRecordType
object
26 properties
PartnerApi.EmisOpen.MedicalRecord38.PathologyReportTypeServiceProvider
object
3 properties
PartnerApi.EmisOpen.MedicalRecord38.AppointmentType
object
15 properties
PartnerApi.EmisOpen.MedicalRecord38.MedicationLinkType
object
3 properties
PartnerApi.EmisOpen.MedicalRecord38.CareAimType
object
6 properties
PartnerApi.EmisOpen.MedicalRecord38.PersonTypeConsulter
integer
PartnerApi.EmisOpen.MedicalRecord38.StringCodeTypeScheme
integer
PartnerApi.EmisOpen.MedicalRecord38.AddressType
object
11 properties
PartnerApi.EmisOpen.MedicalRecord38.TestRequestHeaderTypeFasted
integer
PartnerApi.EmisOpen.MedicalRecord38.MedicalRecordTypeMessageInformationMessagePurpose
object
1 property
PartnerApi.EmisOpen.MedicalRecord38.PathologyReportTypeOriginalMessageDetailsMessageType
integer
PartnerApi.EmisOpen.MedicalRecord38.PersonTypeTwentyFourHour
integer
PartnerApi.EmisOpen.MedicalRecord38.ItemChoiceType
integer
PartnerApi.EmisOpen.MedicalRecord38.ConsultationType
object
24 properties
PartnerApi.EmisOpen.MedicalRecord38.TestRequestType
object
34 properties
PartnerApi.EmisOpen.MedicalRecord38.PersonTypeContraceptive
integer
PartnerApi.EmisOpen.MedicalRecord38.LocationType
object
21 properties
PartnerApi.EmisOpen.MedicalRecord38.EDIOrderTypeStatus
integer
PartnerApi.EmisOpen.MedicalRecord38.PersonTypeChildSurveillance
integer
PartnerApi.EmisOpen.MedicalRecord38.RegistrationHistoryType
object
3 properties
PartnerApi.EmisOpen.MedicalRecord38.AttachmentType
object
32 properties
PartnerApi.EmisOpen.MedicalRecord38.AuthorType
object
2 properties
PartnerApi.Service.Model.Details
object
2 properties
PartnerApi.EmisOpen.MedicalRecord38.MedicalRecordTypeMiscellaneousData
object
2 properties
PartnerApi.Service.Model.SeverityType
integer
PartnerApi.EmisOpen.MedicalRecord38.PersonTypeContractualRelationship
integer
PartnerApi.EmisOpen.MedicalRecord38.PathologyReportType
object
26 properties
PartnerApi.EmisOpen.MedicalRecord38.DrugDeliveryType
object
8 properties
PartnerApi.EmisOpen.MedicalRecord38.RegistrationTypeCustomRegistrationEntry
object
2 properties
PartnerApi.EmisOpen.MedicalRecord38.PersonType
object
49 properties
PartnerApi.EmisOpen.MedicalRecord38.MedicationTypeStatus
integer
PartnerApi.EmisOpen.MedicalRecord38.MedicationTypeIssueMethod
integer
PartnerApi.EmisOpen.MedicalRecord38.MedicalRecordTypeMessageInformation
object
4 properties
PartnerApi.EmisOpen.MedicalRecord38.MedicalRecordTypeRegistrationEntry
object
4 properties
PartnerApi.EmisOpen.MedicalRecord38.PathologyReportTypeIdentifiers
object
2 properties
PartnerApi.Service.Model.Coding
object
3 properties
PartnerApi.EmisOpen.MedicalRecord38.RegistrationStatusTypeCurrentStatus
object
10 properties
PartnerApi.EmisOpen.MedicalRecord38.PathologyTestTypeRangeInformation
object
4 properties
PartnerApi.EmisOpen.MedicalRecord38.MedicationTypePrescriptionType
integer
PartnerApi.EmisOpen.MedicalRecord38.ItemChoiceType1
integer
PartnerApi.EmisOpen.MedicalRecord38.LinkTypeLinkType
integer
PartnerApi.EmisOpen.MedicalRecord38.InvestigationType
object
26 properties
PartnerApi.Service.Model.ErrorResponse
object
4 properties
PartnerApi.EmisOpen.Base64AttachmentData.root
object
2 properties
PartnerApi.EmisOpen.MedicalRecord38.LocationTypeGPLinkCode
object
6 properties
PartnerApi.EmisOpen.MedicalRecord38.TestRequestHeaderType
object
25 properties
PartnerApi.Service.Contracts.Attachment.ProvisionalType
integer
PartnerApi.EmisOpen.MedicalRecord38.PersonTypeRegistrar
integer
PartnerApi.EmisOpen.MedicalRecord38.EventTypeEventType
integer
PartnerApi.EmisOpen.MedicalRecord38.AlertType
object
25 properties
PartnerApi.EmisOpen.MedicalRecord38.PersonCategoryTypePurpose
integer
PartnerApi.EmisOpen.MedicalRecord38.EDIOrderTypeFormDestination
object
6 properties
PartnerApi.EmisOpen.MedicalRecord38.PathologyInvestigationType
object
24 properties
PartnerApi.EmisOpen.MedicalRecord38.PersonTypeMinorSurgery
integer
PartnerApi.EmisOpen.MedicalRecord38.PathologyReportTypeIdentifiersMatchedDetails
object
6 properties
PartnerApi.EmisOpen.MedicalRecord38.TestRequestTypeStatus
integer
PartnerApi.EmisOpen.MedicalRecord38.ElementListTypeConsultationElement
object
11 properties
PartnerApi.Service.Model.Issue
object
4 properties
PartnerApi.EmisOpen.MedicalRecord38.PathologyReportTypeIdentifiersOriginalDetails
object
7 properties
PartnerApi.EmisOpen.MedicalRecord38.TypeOfLocationType
object
6 properties
PartnerApi.EmisOpen.MedicalRecord38.StatusType
object
8 properties
PartnerApi.Service.Model.Text
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

emis-health-medicalrecord-api-openapi.yml Raw ↑

Other APIs EMIS Health publishes across the network.

EMIS-X App Launch
EMIS-X Analytics
EMIS Health Appointments API
EMIS Health CORS API
EMIS Health Health API
EMIS Health Organisation API
EMIS Health Patient API
EMIS Health Patient Matching API
EMIS Health Search API
EMIS Health Swagger API
EMIS Health User API
Where this information came from

This is an independent, third-party profile of EMIS Health Medical Record API, 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.