Query api documentation

@lauraluiz We will review it as planned on thursday.