Fixes #7378 - fixed API lookup keys filters

- forced search to be successful when resource id is provided
- added API documentation for missing parameters
@eLobato that is true, but for other API errors (even other not found errors) we nest the message under :error, so it has the format I used here. Keeping the error format same makes its handling on the client easier.