> in fact I believe it won't return any node

But it does…

We're not forcing it [here](https://github.com/Gizra/restful/blob/7.x-1.x/plugins/restful/RestfulEntityBase.php#L815-L818), nor [here](https://github.com/Gizra/restful/blob/7.x-1.x/plugins/restful/RestfulEntityBase.php#L373-L375).



> to get it filtered by role you pass it in the $request?

I wanted to show how you can build a list for a custom query (maybe eventually not limited within a single entity type) since that is an _actual_ use case. Being exclusively rest is OK for academic purposes, but inconvenient for real use cases. Think about an endpoint listing a label and URI of all the entities that have _field\_dummy_\checkbox_ turned on.

Right now the most abstract case we have is `EFQ` and `entityreference` based, and that has its own limitations, but I don't want to get into that now.

I guess my point here was trying to say: «Hey people, there absolute freedom if you play with the settings in the plugin and override the correct methods.», rather than «you can filter a default listing by a parameter». Maybe we can find a better example (or we can provide both).