api for filter controls