/
REST Web Service Resources in OpenMRS 1.9

REST Web Service Resources in OpenMRS 1.9

Sep 16, 2022

We have migrated to an enhanced online openmrs rest api documentation. Please visit 

https://rest.openmrs.org/#openmrs-rest-api



This page is generated automatically and must not be edited manually. It describes the urls/resources published by the REST Module.

For more information on conventions, authentication, and setup, see the main REST Web Services API For Clients page. 



When a parameter has a bang "!" in front of it, it means that url will only be called if that parameter does NOT exist.

Properties listed in bold must not be null.

ActiveListType

URLs

url

description

url

description

GET /ws/rest/v1/activelisttype

Fetch all non-retired that match any specified parameters otherwise fetch all non-retired

GET /ws/rest/v1/activelisttype/{uuid}

Fetch by unique uuid

POST /ws/rest/v1/activelisttype

Create with properties in request

POST /ws/rest/v1/activelisttype/{uuid}

Edit with given uuid, only modifying properties in request

DELETE /ws/rest/v1/activelisttype/{uuid}?!purge

Retire/Void this object

DELETE /ws/rest/v1/activelisttype/{uuid}?purge

Delete this object from the database

Representations

GET ref

GET default

GET full

POST create

POST update

GET ref

GET default

GET full

POST create

POST update

uuid
display
links

uuid
display
name
description
retired
links
resourceVersion

uuid
display
name
description
retired
auditInfo
links
resourceVersion

name
description

name
description



Allergy

URLs

url

description

url

description

GET /ws/rest/v1/allergy

Fetch all non-retired that match any specified parameters otherwise fetch all non-retired

GET /ws/rest/v1/allergy/{uuid}

Fetch by unique uuid

POST /ws/rest/v1/allergy

Create with properties in request

POST /ws/rest/v1/allergy/{uuid}

Edit with given uuid, only modifying properties in request

DELETE /ws/rest/v1/allergy/{uuid}?!purge

Retire/Void this object

DELETE /ws/rest/v1/allergy/{uuid}?purge

Delete this object from the database

Representations

GET ref

GET default

GET full

POST create

POST update

GET ref

GET default

GET full

POST create

POST update

uuid
display
links

uuid
display
person
activeListType
startDate
endDate
startObs
stopObs
comments
voided
allergyType
reaction
severity
allergen
links
resourceVersion

uuid
display
person
activeListType
startDate
endDate
startObs
stopObs
comments
voided
auditInfo
allergyType
reaction
severity
allergen
links
resourceVersion

person
startDate
comments
startObs
stopObs
allergyType
allergen
reaction
severity

person
startDate
comments
startObs
stopObs
allergyType
allergen
reaction
severity

Cohort

URLs

url

description

url

description

GET /ws/rest/v1/cohort

Fetch all non-retired that match any specified parameters otherwise fetch all non-retired

GET /ws/rest/v1/cohort/{uuid}

Fetch by unique uuid

POST /ws/rest/v1/cohort

Create with properties in request

POST /ws/rest/v1/cohort/{uuid}

Edit with given uuid, only modifying properties in request

DELETE /ws/rest/v1/cohort/{uuid}?!purge

Retire/Void this object

DELETE /ws/rest/v1/cohort/{uuid}?purge

Delete this object from the database

Representations

GET ref

GET default

GET full

POST create

POST update

GET ref

GET default

GET full

POST create

POST update

uuid
display
links

uuid
display
name
description
voided
memberIds
links
resourceVersion

uuid
display
name
description
memberIds
voided
auditInfo
links
resourceVersion

name
description
memberIds

name
description

CohortMember

URLs

url

description

url

description

GET /ws/rest/v1/cohort/{parentUuid}/member/{uuid}

Fetch by unique uuid

GET /ws/rest/v1/cohort/{parentUuid}/member

Fetch all non-retired

POST /ws/rest/v1/cohort/{parentUuid}/member

Create with properties in request

POST /ws/rest/v1/cohort/{parentUuid}/member/{uuid}

Edit with given uuid, only modifying properties in request

DELETE /ws/rest/v1/cohort/{parentUuid}/member/{uuid}?!purge

Retire/Void this object

DELETE /ws/rest/v1/cohort/{parentUuid}/member/{uuid}?purge

Delete this object from the database

Representations

GET ref

GET default

GET full

POST create

POST update

GET ref

GET default

GET full

POST create

POST update

display
links

display
patient
links
resourceVersion

display
patient
links
resourceVersion

patient

patient

Concept

URLs

url

description

url

description

GET /ws/rest/v1/concept

Fetch all non-retired that match any specified parameters otherwise fetch all non-retired

GET /ws/rest/v1/concept/{uuid}

Fetch by unique uuid

POST /ws/rest/v1/concept

Create with properties in request

POST /ws/rest/v1/concept/{uuid}

Edit with given uuid, only modifying properties in request

DELETE /ws/rest/v1/concept/{uuid}?!purge

Retire/Void this object

DELETE /ws/rest/v1/concept/{uuid}?purge

Delete this object from the database

Representations

GET ref

GET default

GET full

POST create

POST update

GET ref

GET default

GET full

POST create

POST update

uuid
display
links

uuid
display
name
datatype
conceptClass
set
version
retired
names
descriptions
mappings
answers
setMembers
links
resourceVersion

uuid
display
name
datatype
conceptClass
set
version
retired
names
descriptions
mappings
answers
setMembers
auditInfo
links
resourceVersion

names
datatype
conceptClass
descriptions
set
version
mappings
answers
setMembers

datatype
conceptClass
set
version
mappings
answers
setMembers
name

Examples

Call Type

Sample URL

Output

Call Type

Sample URL

Output

GET

/ws/rest/v1/concept

Returns a list of top 50 concepts with uuid, display and links

GET

/ws/rest/v1/concept?v=custom:(uuid,name)

Returns a list of top 50 concepts

GET

/ws/rest/v1/concept/cbec024a-8bb4-4fcc-b59b-c7b706bb432e

Returns full description of a concept, including:
uuid, name, display, datatype, conceptClass, set, version, retired, names, mappings, etc.

GET

/ws/rest/v1/concept?q=Yes

Returns list of concepts matching "Yes" with uuid, display and links

GET

/ws/rest/v1/concept?q=COUGH&v=custom:(uuid,name)

Returns list of concepts matching "COUGH" with uuid and name

ConceptClass

URLs

url

description

url

description

GET /ws/rest/v1/conceptclass

Fetch all non-retired that match any specified parameters otherwise fetch all non-retired

GET /ws/rest/v1/conceptclass/{uuid}

Fetch by unique uuid

POST /ws/rest/v1/conceptclass

Create with properties in request

POST /ws/rest/v1/conceptclass/{uuid}

Edit with given uuid, only modifying properties in request

DELETE /ws/rest/v1/conceptclass/{uuid}?!purge

Retire/Void this object

DELETE /ws/rest/v1/conceptclass/{uuid}?purge

Delete this object from the database

Representations

GET ref

GET default

GET full

POST create

POST update

GET ref

GET default

GET full

POST create

POST update

uuid
display
links

uuid
display
name
description
retired
links
resourceVersion

uuid
display
name
description
retired
auditInfo
links
resourceVersion

name
description

name
description

ConceptDatatype

URLs

url

description

url

description

GET /ws/rest/v1/conceptdatatype

Fetch all non-retired that match any specified parameters otherwise fetch all non-retired

GET /ws/rest/v1/conceptdatatype/{uuid}

Fetch by unique uuid

POST /ws/rest/v1/conceptdatatype

Create with properties in request

POST /ws/rest/v1/conceptdatatype/{uuid}

Edit with given uuid, only modifying properties in request

DELETE /ws/rest/v1/conceptdatatype/{uuid}?!purge

Retire/Void this object

DELETE /ws/rest/v1/conceptdatatype/{uuid}?purge

Delete this object from the database

Representations

GET ref

GET ref