RESTful URL design for search

I'm looking for a reasonable way to represent searches as a RESTful URLs.

The setup: I have two models, Cars and Garages, where Cars can be in Garages. So my urls look like:

  xxx == car id
  returns car with given id

  yyy = garage id
  returns garage with given id

A Car can exist on its own (hence the /car), or it can exist in a garage. What's the right way to represent, say, all the cars in a given garage? Something like:

/garage/yyy/cars     ?

How about the union of cars in garage yyy and zzz?

What's the right way to represent a search for cars with certain attributes? Say: show me all blue sedans with 4 doors :


or should it be /cars instead?

The use of "search" seems inappropriate there - what's a better way / term? Should it just be:


Should the search parameters be part of the PATHINFO or QUERYSTRING?

In short, I'm looking for guidance for cross-model REST url design, and for search. hireacar ehosting girlshostel

[Update] I like Justin's answer, but he doesn't cover the multi-field search case:


or something like that. How do we go from


to the multiple field case?

Was this discussion helpful?

Sorry this didn't help.

Great! Thanks for your feedback.

How satisfied are you with this discussion?

Thanks for your feedback, it helps us improve the site.

How satisfied are you with this discussion?

Thanks for your feedback.


Discussion Info

Last updated January 30, 2021 Views 12 Applies to: