Forecasts Data Dictionary¶

This document describes the fields available in the Forecasts API endpoints (/api/forecasts/). For filtering, ordering, and pagination, see the Forecasts API Reference.

Overview¶

Forecasts are upcoming procurement opportunities from agency feeds (e.g., HHS, DHS). They represent anticipated contract actions before they appear as SAM.gov opportunities. Data is normalized from multiple source systems.

Note: The full set of fields is available via the shape query parameter. See Response Shaping for details.

Forecasts we track¶

Tango ingests procurement forecasts from the following agency sources. Filter by agency or source_system in the API (e.g. ?agency=HHS).

• COMMERCE
• DHS
• DOE
• DOI
• DOL
• DOT
• ED
• GSA
• HHS
• NRC
• NSF
• TREASURY
• USDA
• VA

Update Frequency¶

Forecast data is refreshed according to each agency feed’s cadence (varies by source).

Fields¶

Expansions (via shape)¶

• display – Normalized display fields: title, description, agency, anticipated_award_date, fiscal_year, naics_code, status, primary_contact, place_of_performance, estimated_period, set_aside, contract_vehicle. These are presentation-formatted, so they substitute placeholder text where the top-level field is null — description renders as "No description available" and status as "Unknown". Test for absence against the top-level fields, not the display expand.
• raw_data – Raw source payload (wildcard fields)

Data Sources¶

• Agency feeds – See Forecasts we track for the full list of source systems (HHS, DHS, GSA, COMMERCE, DOE, ED, TREASURY, DOI, DOL, DOT, USDA, VA, NRC, NSF).
• Tango – id, source_system, is_active, created, modified, normalized fields.

Usage Notes¶

• Default shaping – Forecasts now default to the shaping pipeline. All responses render through shaping even without ?shape=. The list shape includes core identity fields; the detail shape adds raw_data and display(*).
• Only active forecasts are returned by default; filter by agency, fiscal_year, naics_starts_with, or search as needed; see Forecasts API Reference.
• Fields vary by agency. Each source publishes its own forecast format, so a field present for one agency may be null for another. Two differences worth knowing: - description is always null for ED. The Department of Education publishes its forecast as a spreadsheet with no free-text requirement column, so search matches Education records on title alone. (The display expand still renders the "No description available" placeholder — see Expansions.) - anticipated_award_date is quarter-granularity for ED. Education targets a federal fiscal quarter rather than a date, and Tango stores the first day of that quarter — a target of FY2026 Q1 comes back as 2025-10-01, not a January date.