Get patient

Fetches a single patient by ID.

Transaction Specification

URL: GET /ws/rest/v1/patient/$<pat-ID>

Description: This transaction fetches a client specified by the ID supplied.


The GET request contains one required parameter for patient ID.


This parameter represents a patient's ID. It must be specified in the following format:
Where <ID-type> is one of the following:

  • NID - for a national identification number
  • MUT - Mutuelle number
  • RAM - Rama number
  • OMRS<fosaid of facility> - OpenMRS identifier eg, OMRS357-123456789

Eg. GET /ws/rest/v1/patient/NID-1234567890123


HTTP 200 - OK


See UC01.002 Maintain Client Registry for the latest data structure for this section.

Messaging specification

The HL7 message will be a HL7 v2.5 ADT_A28 message with the following structure:
See Register-or-Query-Client


HTTP 500 - Server Error - If the server encountered an error.

HTTP 404 - Not Found - If the patient cannot be found


This section describes how this transaction is orchestrated through the HIM (interoperability layer) in order to complete this transaction.

  1. Call Get client

Sample Messaging Implementation

Scenario 1

Fetches a single patient by ID

User Interface


Sample Request Message


Sample Response Message

Note: This message is very incomplete and requires revision:

<ADT_A05 xmlns="urn:hl7-org:v2xml">