The REST APIs would be A LOT easier to work with if there were two additional fields returned. Let's just call them message1 and message2.
These two fields would correspond with the same information that you get when you enter data into a screen. When you enter data into a screen in Acumatica, you either get a Warning (in yellow) or an Error (in red).
message1 would return either "warning" or "error".
message2 would return the same message that you get on the screen.
For example, let's say I try to enter the following bad data into the Sales Orders screen. In this example:
message1 = "error"
message2 = "Error: 'Location' cannot be found in the system."
If I try to enter the same bad data into the REST API, I get an error message. But it's really ugly. The relevant message is there (highlighted in red below), but it's buried in a bunch of technical vomit.
It would be great if we could get two fields that give us the same data we would see on the screen. It would make working with the REST APIs a lot easier.
Also, I'm told there is a similar problem with the SOAP APIs.