added optional 'onlyIds' api parameter