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.

{
  "patientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "officialName": {
    "prefix": "string",
    "givenName": "string",
    "middleNames": "string",
    "familyName": "string",
    "suffix": "string"
  },
  "homeAddress": {
    "line1": "string",
    "line2": "string",
    "line3": "string",
    "locality": "string",
    "administrativeArea": "string",
    "postalCode": "string",
    "country": "string"
  },
  "dateOfBirth": "2025-01-01",
  "gender": "string",
  "nhsNumber": "string",
  "homeTelephoneNumber": "string",
  "mobileTelephoneNumber": "string",
  "workTelephoneNumber": "string",
  "emailAddress": "string"
}

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)

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