GET/transactional-api/patient/:patientId/demographics

Get Patient Demographics

Returns the demographic details for a single patient. Empty fields are omitted from the response.

Authorization: Bearer token (JWT). See Authentication.

Request

curl -L -X GET 'https://{tenantId}.api.england.medicus.health/transactional-api/patient/:patientId/demographics' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>'

Path and query parameters

Name	In	Type	Required	Description
patientId	path	string<uuid>	Yes	Medicus patient identifier.

Responses

200 Patient demographics.

Response fields

Field	Type	Description
patientId	string<uuid>	Medicus patient identifier.
officialName.prefix	string
officialName.givenName	string
officialName.middleNames	string
officialName.familyName	string
officialName.suffix	string
homeAddress.line1	string
homeAddress.line2	string
homeAddress.line3	string
homeAddress.locality	string
homeAddress.administrativeArea	string
homeAddress.postalCode	string
homeAddress.country	string
dateOfBirth	string<date>
gender	string
nhsNumber	string
homeTelephoneNumber	string
mobileTelephoneNumber	string
workTelephoneNumber	string
emailAddress	string

{
  "patientId": "4d59c916-9726-11ec-af3f-0a58a9feac02",
  "officialName": {
    "prefix": "Mr",
    "givenName": "Frodo",
    "middleNames": "Drogo",
    "familyName": "Baggins",
    "suffix": "Esq"
  },
  "homeAddress": {
    "line1": "Flat 6",
    "line2": "16-19",
    "line3": "Commercial Row",
    "locality": "Doc Penfro",
    "administrativeArea": "Pembrokeshire",
    "postalCode": "SA72 6LA",
    "country": "England"
  },
  "dateOfBirth": "1971-07-09",
  "gender": "male",
  "nhsNumber": "9693646525",
  "homeTelephoneNumber": "07958 662735",
  "mobileTelephoneNumber": "07700 900321",
  "workTelephoneNumber": "01646 683000",
  "emailAddress": "caitriona.mccormack@medicus.health"
}

400 Validation error.

3 possible code values

Code	Description	When
invalid-patient-id	The patientId is not a UUID	patientId not a UUID
patient-not-found	Patient not found for this patientId	patientId doesn't exist
patient-restricted	Access to this patient is restricted for this staff member.	patient record is marked as restricted in Medicus; only explicitly permitted staff members can access it (not a configuration error, handle gracefully)

Response fields

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

{
  "errors": [
    {
      "code": "invalid-patient-id",
      "description": "The patientId is not a UUID"
    }
  ]
}