GET/transactional-api/research/study-linked-records/:studyId/:patientId

List Research Study Linked Records

Returns the care record elements a practice has linked to a patient's participation in a research study. Linking is optional, so this returns what has been linked, not a complete inventory of the patient's care record. Returns an empty list when the patient's participation in the study is not ongoing.

Authorization: Bearer token (JWT). See Authentication.

Request

curl -L -X GET 'https://{tenantId}.api.england.medicus.health/transactional-api/research/study-linked-records/3fa85f64-5717-4562-b3fc-2c963f66afa6/4d59c916-9726-11ec-af3f-0a58a9feac02' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>'

Path and query parameters

Name	In	Type	Required	Description
studyId	path	string<uuid>	Yes	The id of the research study, as returned by List Research Studies.
patientId	path	string<uuid>	Yes	Medicus patient identifier.

Responses

200 Linked care record elements for this patient in the study.

[
  {
    "participantIdentifier": "ABC-0061",
    "resourceType": "Observation",
    "resourceId": "7b20c1a2-9726-11ec-af3f-0a58a9feac02"
  }
]

404 Research study not found.

Response fields

Field	Type	Description
errors[].code	string
errors[].description	string

{
  "errors": [
    {
      "code": "research-study-not-found",
      "description": "Research study not found for id: 3fa85f64-5717-4562-b3fc-2c963f66afa6"
    }
  ]
}