pia_oversight_recommendations
Search open oversight recommendations from GAO and Oversight.gov with faceted filters by status, priority, agency, and theme. Get total counts, sample results, and a link to the full set.
Instructions
Search oversight recommendations (Open Recommendations dataset) with facets enabled by default. Today's date is 2026-06-25. This dataset contains recommendations from GAO and Oversight.gov only — SourceDocumentDataSource filters for any other source will be ignored. Do NOT filter by SourceDocumentDataSet — this tool already targets the 'Open Recommendations' dataset automatically. IMPORTANT: When a text query is provided, do NOT add a referenced_agencies filter — the query handles relevance matching. Only use referenced_agencies when the query is empty (pure filter/facet lookups). total_count is the number of OPEN recommendations matching the query and all applied filters — report it as that count. The results are a representative sample to summarize, and facets break the set down by status, priority, agency, and theme. Counts from free-text queries are approximate (semantic matching); pure filter or agency lookups are exact. Recommendations have no per-document citations, so it is very important to always include the govquery_url for the full set in Rec Spotlight rather than citing individual rows.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number (default: 1) | |
| limit | No | Maximum results limit | |
| query | Yes | Search query text | |
| filter | No | Optional OData filter expression supporting complex boolean logic. AVAILABLE FIELDS: • SourceDocumentDataSource: Data source/agency that published the document. Major sources (>1k documents): 'Department of Justice', 'Congress.gov', 'Oversight.gov', 'CRS', 'GAO', 'Federal Register' • SourceDocumentDataSet: Dataset or collection the document belongs to. Values include: 'reports', 'federal-reports', 'press-releases', 'executive orders', 'Open Recommendations'. Note: the value is 'Open Recommendations' (not 'recommendations'). Values: 'press-releases', 'bills-and-laws', 'reports', 'federal-reports', 'executive orders', 'state-and-local-reports', 'annual-financial-reports', 'congressional-justification-reports', 'performance-and-accountability-reports' • SourceDocumentTitle: Document title - use contains, eq for text matching • SourceDocumentPublishDate: Publication date - ISO 8601 format YYYY-MM-DD (e.g., '2023-01-01'). Use ge/le for ranges • RecStatus: Recommendation status • RecPriorityFlag: Priority flag for recommendations • SourceDocumentIsRecDoc: Whether the document contains recommendations. Values: 'No', 'Yes' • RecFraudRiskManagementThemePIA: Fraud risk management theme classification • RecMatterForCongressPIA: Whether the matter is for Congressional attention • RecRecommendation: Recommendation text - use contains, eq for text matching • RecAgencyComments: Agency comments on recommendations - use contains, eq for text matching • referenced_agencies: Agencies referenced by documents (collection field). IMPORTANT: Only use this filter when the query is empty (pure filter/facet lookups). Do NOT combine with a text query — the query already handles relevance matching. Example: (referenced_agencies/any(a: a eq 'Department of Defense (DOD)') or referenced_agencies/any(a: a eq 'Department of Justice (DOJ)')) - for single agency omit outer parentheses and 'or'. Get all values via pia_search with facets_only=true. OPERATORS: • Text: contains, eq, ne, startswith, endswith • Exact: eq (equals), ne (not equals), in (in list) • Date: ge (greater/equal), le (less/equal), eq (equals) • Logic: and, or, not, parentheses for grouping EXAMPLES: • "SourceDocumentDataSource eq 'GAO'" • "SourceDocumentDataSource eq 'GAO' and RecStatus ne 'Closed'" • "(SourceDocumentDataSource eq 'GAO' or SourceDocumentDataSource eq 'OIG') and RecStatus eq 'Open'" • "SourceDocumentPublishDate ge '2020-01-01' and SourceDocumentPublishDate le '2024-12-31'" TIP: Use pia_search with facets_only=true to get the most current available values. COMMON AGENCY NAMES (use EXACT spelling for referenced_agencies): Department of Defense (DOD), Department of Health and Human Services (HHS), Department of Homeland Security (DHS), Department of Justice (DOJ), Department of Education (ED), Department of Veterans Affairs (VA), Department of the Treasury, Department of Agriculture (USDA), Department of the Interior (DOI), Department of Transportation (DOT), Department of Energy (DOE), Department of State, Department of Labor (DOL), Department of Commerce (DOC), Department of Housing and Urban Development (HUD), Environmental Protection Agency (EPA), National Aeronautics and Space Administration (NASA), Social Security Administration (SSA), Small Business Administration (SBA), Office of Personnel Management (OPM), General Services Administration (GSA) | |
| page_size | No | Results per page (default: 100) | |
| facets_only | No | Return ONLY the facet breakdown + total_count + Rec Spotlight govquery_url, omitting the individual recommendation rows — to see the open-rec population broken down by status/priority/agency/theme without pulling rows. | |
| search_mode | No | Search mode (default: content) | content |
| include_facets | No | Include facets in results (default: true) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| output | Yes |