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
- GSA
- HHS
- NRC
- TREASURY
- VA
Update Frequency¶
Forecast data is refreshed according to each agency feed’s cadence (varies by source).
Fields¶
| Field | Type | Description | Source |
|---|---|---|---|
id | Integer | Primary key for the forecast in Tango. | Tango |
source_system | String | Agency or system that provided the forecast (e.g., "HHS", "DHS"). | Tango |
external_id | String | Identifier from the source system. | Agency feed |
agency | String | Agency acronym or name. | Agency feed |
title | String | Forecast title. | Agency feed |
description | String | Forecast description. | Agency feed |
anticipated_award_date | Date | Expected award date. | Agency feed |
fiscal_year | Integer | Federal fiscal year. | Agency feed / Tango |
naics_code | String | NAICS code. | Agency feed |
is_active | Boolean | Whether the forecast is active. | Tango |
status | String | Status (e.g., active, cancelled). | Agency feed |
created | DateTime | When the record was created in Tango. | Tango |
modified | DateTime | When the record was last updated. | Tango |
primary_contact | Object | Primary contact for the forecast (display-derived). | Agency feed |
place_of_performance | String | Place of performance (display-derived). | Agency feed |
estimated_period | String | Estimated period of performance (display-derived). | Agency feed |
set_aside | String | Set-aside designation (display-derived). | Agency feed |
contract_vehicle | String | Contract vehicle type (display-derived). | Agency feed |
raw_data | Object | Raw JSON from the source (expand for full payload). | Agency feed |
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_vehicleraw_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, TREASURY, DOI, DOL, DOT, VA, NRC).
- 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 addsraw_dataanddisplay(*). - Only active forecasts are returned by default; filter by
agency,fiscal_year,naics_starts_with, orsearchas needed; see Forecasts API Reference.