I am struggling with architecture on a new project. I am using the following patterns/technology.

  • CQRS - anything going in goes through a command
  • REST - using WebAPI
  • MVC - asp.net mvc
  • Angular - building a spa
  • nhibernate

I belive this provides some great separation and should help keep a very complex domain from growing into a giant set of services that mix queries with other business logic.

  • The REST services have become non restful. They are putting methods in rest that are "SearchByDate", "SearchByItem" etc.
  • Service Methods that execute commands are called with a "web" model class, a new command is built in the service and executed, I feel like there is a lot of extra code.

I expected this to be much different but I wasn't around to keep things on track.

Finally my questions are this...

I would have liked to see PUT Person (CreatePersonCommand) but then I realized that isn't restful either is it? the put should be a person entity not a command.

Can I make CQRS and REST service work together or am I going about this all wrong?

How do I handle service methods that don't fit into a REST model. I am not performing CRUD on the object but rather executing some business logic. I.E. I don't want the UI to be responsible for how a shipment is "unshipped" I want the service layer to worry about that.

  • REST works OK with a command model... the commands basically become nouns, or worker resources.

So instead of using


You'd have a "search" (noun) resource


I've always felt that's kind of a word game, but it does has the benefit of keeping your semantics resource oriented.

  • In the case where the verb directly mirrors an HTTP verb, just omit it.

Instead of


it's just PUT to


...the call is the same, it's just that you're using the HTTP verb (PUT) instead of duplicating that in the resource name.

CQRS is about splitting up your writers from your readers. It would be fair game under both CQRS and REST to add some resources that only accept POST -- using the "data processing" clause for POST provided in the HTTP spec. POST data for processing, then GET the resulting resources.

But as long as your resource names boil down to nouns rather than verbs, you can keep all the purists happy.


A Command name is just a combination of action + target. You're concatenating those to create your Command names "ActionTargetCommand".


  • the target goes in the base URI

  • the action becomes the method or else implied from the query string

  • and Command just goes away as redundant

"ACTION htpp://blah/Target?ActionParameter=".

You either need to make your action one of the HTTP methods, or else turn the resource into a processor noun.

One one level, it's just renaming to suit a resource-oriented paradigmn, but on a deeper level is a matter of splitting the commands into those covered by the HTTP methods, and others into processing nouns.

  • I think I didn't word the question well... I will update it. I know that I just need person and the verb describes what the action is. what I am missing is how to tie this into commands.
    – Paul Wade
    Jun 3 '14 at 19:51
  • I added a little to the answer if that helps. Mainly it's just a slight difference in naming conventions. But it might also have an impact on the implementation.
    – sea-rob
    Jun 3 '14 at 20:01
  • Using nouns isn't really about being a purist. It's about understanding that REST is designed to deal with entities/resources. The verbs are in the HTTP methods (GET, etc.). Therefore, to find a Person by name, you would say /Persons?name="Thomas". This is saying "Give me a list of all Persons whose name is "Thomas".
    – Jonathan M
    Dec 30 '19 at 21:02

You probably need Event Sourcing then. Basically you store each event in something that resembles a serial queue and have some service process pick up the events on the queue and execute them. That way you can separate the code that submits the events from the code that executes their effects. You also get the benefit of being able to replay the events to reconstitute object state. I suggest you do some googling for Event Sourcing. It's a common companion to CQRS.

  • @MetaFight I edited the answer to be more clear. Nov 13 '17 at 17:53
