filtering previsto api reference.