POST/transactional-api/find-patient

Find Patient

Free-text search for patients by name, NHS number, date of birth, or other demographics. Returns a list of matching patients.

Authorization: Bearer token (JWT). See Authentication.

Request

curl -L -X POST 'https://{tenantId}.api.england.medicus.health/transactional-api/find-patient' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>' \
  -d '{
    "query": "Smith",
    "includeInactivePatients": false
  }'

Body parameters

Field	Type	Required	Description
query	string	Yes	Free-text search term (e.g. name, NHS number).
includeInactivePatients	boolean	No	When true, inactive patients are included in the results.

Responses

200 Matching patients.

[
  {
    "patientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "displayName": "string",
    "nhsNumber": "string",
    "dateOfBirth": "2025-01-01",
    "address": {
      "line1": "string",
      "line2": "string",
      "line3": "string",
      "locality": "string",
      "administrativeArea": "string",
      "postalCode": "string",
      "country": "string"
    },
    "genderIdentity": "string",
    "active": false
  }
]

400 Validation error: query is missing.

{
  "errors": [
    {
      "code": "missing-query",
      "description": "No search query is specified"
    }
  ]
}