Last chance to register for OpenMRS Worldwide Summit!

#OMRS15, the 1st OpenMRS Worldwide Summit, is 8-14 December. Registration is still available & the event schedule is online. More information:

Wiki Spaces


Get Help from Others

Q&A: Ask OpenMRS »
Discussion: OpenMRS Talk »
Real-Time: IRC Chat


Skip to end of metadata
Go to start of metadata

OpenMRS has a Java API that provides access to the complex underlying data model. This API can and is used in many different applications, the primary of which is the reference "war" application.

Many languages are not able to take advantage of this api, however. For other external consumers of OpenMRS data and services we provide links through the web services modules.

REST Web Services

The preferred and supported method of web services in openmrs is through the REST Module. See that page for how to install and configure the module. You can also read about the REST Web Services API For Clients, and the provided REST Web Service Resources in OpenMRS 1.8.

(There is also an older Unsupported REST Module that provides simple access to patients, obs, and users.  However, this will no longer be supported in favor of the previously mentioned module)

SOAP Web Services

There are several modules that provide SOAP Web Services methods. This only works for OpenMRS 1.6.0+ and is not supported by the core team like the REST Module.

  • No labels