How to use REST module to post/add an order?

Application Name: Platform 1.9.8

Question: Hello, I wanted to ask how to use the rest module to add an order in the simple lab entry module. i keep getting the

"ERROR - BaseRestController.handleException(106) |2016-02-20 09:42:29,271| When creating a resource that supports subclasses, you must indicate the particular subclass with a type property"

error in the system log and i can only assume that the “body content” is wrong in some way. Whether it’s the format or the lack of information. I was hoping to see an example of the rest module being used to post an order. Thank you very much

I have updated our REST API documentation and added a section about “Resources with Subtypes” to describe this.

In this case you need to add a t property to indicate what type of order you are creating (under the hood, what Java subclass will represent the order). So for a lab test you need to include a property like:

"t": "testorder"

Thank you for the reply. But I’m still unclear as to exactly where in the body content to insert it. and what the ‘test order’ value should be. is it text? or a uuid? is it the ordertype/drug order? Where in this sample post would that be added? and does it need [ ] like when posting a patient with diff names?

Type: POST
Uri: /openmrs198/ws/rest/v1/order

Body Content:
 "patient":"46003548-1ffd-4903-95cb-7c9c6056ae00", //UUID of the person (also a patient)
 "ordertype":"f7052b1d-639b-4053-8282-a006a06c3b1d", //UUID of the ordertype (value is 'radiology')
 "concept":"161478AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA" //UUID of a concept from the dictionary (value is 'Anti-streptolysin O test')

Representation: full

In the ‘Add Order Module’, those are the three values that are required to post. So I’m keeping the post as minimal as needed until i succesfully make a post to add an order. Thank you

1 Like

Add a "t":"testorder" property to your post body, exactly like I typed it in my message and see if that works…

Oh ok. I’ll try it once I get back in the office on Monday since I don’t have openmrs installed on my home pc. Thank you and I’ll update once I’ve tried it

Hello, I tried adding it and it still didn’t work


This is the system log:

WARN - ExtensionPointTag.doStartTag(136) |2016-02-22 09:21:32,811| Extensions at this point ( are required to be of class org.openmrs.module.web.extension.LinkExt or a subclass. class org.openmrs.module.simplelabentry.extension.html.LabGutterItem is not.
ERROR - BaseRestController.handleException(106) |2016-02-22 09:21:44,740| When creating a resource that supports subclasses, you must indicate the particular subclass with a type property


Sorry for the long delay on this. I finally got a chance to test this out, and I was wrong: the property should have been “type”, not “t”. (I don’t know why we use different properties for when you’re doing a query (t) vs posting to create something (“type”).)

A full working example, tested against, is:

    "type": "testorder",
    "patient": "1681f4b7-7f4d-4227-9562-718ee347bbd8",
    "encounter": "8a32e7cb-0bbb-4c4e-8ed4-fc982443859f", // orders must have an encounter
    "orderer": "9e28cb36-0df4-4972-b375-4a5ff88e39d9", // from the provider resource
    "careSetting": "c365e560-c3ec-11e3-9c1a-0800200c9a66" // from the caresetting resource

See the response at:

Just after posting this, I realize that you’re asking about OpenMRS Platform 1.9.x. My example above uses the completely new order entry API introduced in Platform 1.10.

Even in earlier versions of the API, “type” is the property that you need to specify to get around the error you’re seeing.

Peeking at the REST web services module code, I see that “testorder” is not supported until Platform 1.10, even though test orders were added in 1.9.2 as part of TRUNK-3749.

So if you want to be able to do what you’re talking about here against the Platform 1.9.8 REST API, you will need to add support for this to the REST web services module, by adding an equivalent of for 1.9.

Hi darius, i am a newbie to OpenMRS and would need some help with using the Rest services. Where can I review the values for Caresetting? I did not see it in the admin screens.

Thanks, Tim


Have you looked at (and then look at the caresetting resource)?

Also, read about the Order Entry API at

thanks. Found it.

@darius wow I completely forgot about this… This project got put on hold and I was made to do something else. Once I’m made to continue it I’ll try this. thanks for the reply and sorry for not responding.

Hi @darius I need to post a custom ordertype say procedureorder as part of an encounter payload

"type": "procedureorder",
"patient": "1681f4b7-7f4d-4227-9562-718ee347bbd8",
"encounter": "8a32e7cb-0bbb-4c4e-8ed4-fc982443859f", // orders must have an encounter
"orderer": "9e28cb36-0df4-4972-b375-4a5ff88e39d9", // from the provider resource
"careSetting": "c365e560-c3ec-11e3-9c1a-0800200c9a66" // from the caresetting resource


How can I go about this.

@darius this will not work on my local instance platform 2.1.3 Refapp 2.8.0. also looks like was only up for a certain period.

@tendomart what do you mean by it will not work?

@dkayiwa thanks ,what i actually meant is i tried posting but failed with a 500 Error on my local instance and the devtest02 server could not be accessed either.

Are you able to reproduce it at?

@dkayiwa Tried it and it still responds with a 500 error !

This is exactly what i got on my local instance.

The swagger ui and Documentation can’t be generated either. with info " No spec provided. "