GET/transactional-api/audit-event/:auditEventId

Get Audit Event

Returns one audit event with the detail it recorded. details is whatever the event captured: it varies by event type and changes as the underlying records change, so read it defensively and do not depend on any entry being present.

Authorization: Bearer token (JWT). See Authentication.

Request

curl -L -X GET 'https://{tenantId}.api.england.medicus.health/transactional-api/audit-event/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>'

Path and query parameters

Name	In	Type	Required	Description
auditEventId	path	string<uuid>	Yes	The id of the audit event, as returned by List Patient Audit Events.

Responses

200 The audit event.

Response fields

Field	Type	Description
id	string<uuid>
eventName	string
eventDateTime	string<date-time>
patientId	string<uuid> (nullable)
entityId	string<uuid>	The record the event was recorded against.
performedBy.name	string (nullable)
performedBy.organisation	string (nullable)
details[].label	string
details[].value	``

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "eventName": "Patient Added to Research Study",
  "eventDateTime": "2026-08-28T08:05:25+00:00",
  "patientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "entityId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "performedBy": {
    "name": "Dr Lara Lincoln",
    "organisation": "Riley House GP Practice"
  },
  "details": [
    {
      "label": "Study",
      "value": "Semaglutide in Primary Care"
    }
  ]
}

404 Audit event not found.

Response fields

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

{
  "errors": [
    {
      "code": "audit-event-not-found",
      "description": "Audit event not found for id: 3fa85f64-5717-4562-b3fc-2c963f66afa6"
    }
  ]
}