Source catalog
CMS Contract Opportunities
Centers for Medicare & Medicaid Services acquisition forecasts.
Source, grain and coverage
Public forecast workbooks, with source-document and row provenance. Plans may change before procurement.
Workbook row numbers identify source evidence, rather than permanent requirements. Agency codes, fiscal years and classifications can be absent. Plans, estimated dates and values can change before procurement.
Collection schedule: Daily; unchanged workbooks may produce no new records.
Records describe public source observations. Missing values remain unknown; historical observations do not establish current status.
Definitions audited . Use source status and the returned watermarks to inspect current collection health.
REST and MCP access
Use a credential with intelligence scope and enable that data domain in your workspace.
curl 'https://www.govbiz.ai/api/v2/catalogue/sources/cms-forecast-refresh/records?limit=2' \ -H "Authorization: Bearer $GOVBIZ_API_KEY"
The primary dataset is acquisition_forecasts. Select another dataset from this source with dataset_id. Supported field names can be used as exact filters; the versioned query endpoint also supports declared ranges and list operators.
Through canonical /mcp, use govbiz_discover_datasets, govbiz_describe_dataset, govbiz_search_records, and govbiz_get_evidence. Cross-source relationships use govbiz_get_related_records and require access to every involved domain.
API contracts · MCP setup · Workspace data domains
Query this source →Acquisition Forecasts
acquisition_forecasts · Schema 1
One current retained version of a source-qualified forecast record per forecast_id; source_key identifies the publishing feed rather than necessarily the buying agency.
Search modes: structured, lexical. History: Current retained projection; exact historical reconstruction is unsupported.
Measures: record_count. Monetary values use decimal strings with declared units. Unknown amounts do not become zero.
Field definitions and supported filters · 54 fields
| Field | Type / unit | Meaning | Availability and filters |
|---|---|---|---|
forecast_id | string | Source-record UUID in the forecast current view.Storage and value limits: 128-bit identifier; JSON string; does not prove source identity. | Values can be missingeq, in, is_null, contains |
canonical_requirement_id | string | GovBiz resolved requirement identity shared by confirmed memberships.Storage and value limits: 128-bit identifier; JSON string; does not prove source identity. | Values can be missingeq, in, is_null, contains |
source_id | string | GovBiz source-registry UUID in these SQL relations; not the collector job ID or publisher record ID.Storage and value limits: 128-bit identifier; JSON string; does not prove source identity. | Values can be missingeq, in, is_null, contains |
source_key | string | Stable registry source key; separate from UUID and collector job aliases.Storage and value limits: Maximum 120 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |
source_name | string | Human source/publisher label.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
source_record_id | string | Publisher-native record identifier, or explicitly marked fallback identity, within a source.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
source_record_url | string | Public publisher URL for a particular record when available.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
source_document_url | string | Public publisher URL for the source file/document.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
record_type | string | Source record kind; grants synopsis/forecast and acquisition forecast/expiring/bid-board differ.Storage and value limits: Maximum 48 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |
first_observed_at | datetime | Earliest retained observation of this record/source identity.Storage and value limits: Instant with timezone only if declared; otherwise local/producer time must be explicitly interpreted. Do not invent clock precision. | Values can be missingeq, in, is_null, gte, lte |
last_observed_at | datetime | Most recent retained observation of this record/source identity, including unchanged observations.Storage and value limits: Instant with timezone only if declared; otherwise local/producer time must be explicitly interpreted. Do not invent clock precision. | Values can be missingeq, in, is_null, gte, lte |
is_active | boolean | Stored source record lifecycle flag; not an award or procurement approval.Storage and value limits: Boolean physical type; defaults/omitted source fields can still mean unverified or not collected. | Values can be missingeq, in, is_null |
forecast_version_id | string | Identifier of the particular normalized forecast version.Storage and value limits: 128-bit identifier; JSON string; does not prove source identity. | Values can be missingeq, in, is_null, contains |
retrieval_id | string | Immutable public source retrieval reference used for evidence.Storage and value limits: 128-bit identifier; JSON string; does not prove source identity. | Values can be missingeq, in, is_null, contains |
parser_version | string | Parser/normalization implementation version used for a stored parse.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
agency_code | string | Stored source agency identifier; namespace can be CGAC, FPDS, top-tier or publisher-specific and must be declared.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ.Every current forecast view agency code is null; organization resolution must be explicit. | Not collected; returned as unknowneq, in, is_null, contains |
agency_name | string | Source agency name; a label whose scope can be department, bureau or office.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
subagency_code | string | Source bureau/subagency identifier, not automatically the same namespace as agency_code.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
subagency_name | string | Source bureau/subagency label.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
contracting_office_code | string | Source contracting-office identifier; requires an issuer/office namespace.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
contracting_office_name | string | Source contracting-office label.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
fiscal_year | integer | Source/derived US federal fiscal year; October 1 starts the following numbered year, with source-specific precision.Storage and value limits: Signed 32-bit integer; logical domain constraints can be narrower. | Values can be missingeq, in, is_null, gte, lte |
requirement_title | string | Published planned acquisition requirement title.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
requirement_description | string | Publisher description of a planned requirement.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
naics_code | string | Source industry classification code; link with the NAICS edition and declared precision.Storage and value limits: Maximum 12 characters; identifier rules can be narrower.Require a classification edition; do not join broad prefixes as exact identities. | Values can be missingeq, in, is_null, contains |
psc_code | string | Product and Service Code classification; it is not a NAICS industry code.Storage and value limits: Maximum 16 characters; identifier rules can be narrower.Classification overlap is contextual, not record identity. | Values can be missingeq, in, is_null, contains |
estimated_value_min | decimal / USD | Normalized lower endpoint of a publisher acquisition estimate; preserve the original range and open-bound wording.Storage and value limits: Precision 20, scale 2; absolute value below 10^18; rounding on assignment; checks can narrow the range.Current parser converts numeric tokens to min/max and may lose open-bound wording or partial suffixes; retain estimated_value_text. | Values can be missingeq, in, is_null, gte, lte |
estimated_value_max | decimal / USD | Normalized upper endpoint of a publisher acquisition estimate; a range parser can lose open-bound meaning.Storage and value limits: Precision 20, scale 2; absolute value below 10^18; rounding on assignment; checks can narrow the range.Current parser converts numeric tokens to min/max and may lose open-bound wording or partial suffixes; retain estimated_value_text. | Values can be missingeq, in, is_null, gte, lte |
estimated_value_text | string | Original publisher estimate/range text retained for interpretation and provenance.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
estimated_solicitation_date | date | Planned solicitation date; HHS month/year values are currently converted to the first day.Storage and value limits: Calendar date without time of day or timezone; source precision can be month/quarter instead. | Values can be missingeq, in, is_null, gte, lte |
estimated_solicitation_quarter | string | Publisher anticipated solicitation quarter label; do not synthesize an exact day.Storage and value limits: Maximum 12 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |
estimated_award_date | date | Planned award date; month/quarter precision must remain explicit.Storage and value limits: Calendar date without time of day or timezone; source precision can be month/quarter instead. | Values can be missingeq, in, is_null, gte, lte |
estimated_award_quarter | string | Publisher anticipated award quarter label; do not synthesize an exact day.Storage and value limits: Maximum 12 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |
period_of_performance_start | date | Published forecast planned performance start date.Storage and value limits: Calendar date without time of day or timezone; source precision can be month/quarter instead. | Values can be missingeq, in, is_null, gte, lte |
period_of_performance_end | date | Published forecast planned performance end date.Storage and value limits: Calendar date without time of day or timezone; source precision can be month/quarter instead. | Values can be missingeq, in, is_null, gte, lte |
place_of_performance_city | string | Source city of the place of performance; distinct from recipient legal address.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
place_of_performance_state | string | Source state/territory of the place of performance; distinct from recipient legal address.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
place_of_performance_country | string | Source country of the place of performance; distinct from recipient legal address.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
competition_type | string | Publisher planned competition category; not an observed competition outcome.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
set_aside_type | string | Source set-aside label/category; categories and aliases must not be guessed.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
small_business_program | string | Published small-business program label on an acquisition plan.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
acquisition_strategy | string | Publisher acquisition-plan strategy text.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
contract_vehicle | string | Publisher vehicle plan label; not proof of a task-order/parent relationship.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
contract_type | string | Publisher intended contract instrument/pricing category.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
new_or_follow_on | string | Publisher new/follow-on planning label; distinguish from a confirmed predecessor link.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
incumbent_name | string | Publisher named incumbent; a label needing identity resolution.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
incumbent_award_id | string | Publisher incumbent contract reference; qualify by agency/issuer before joining.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
forecast_status | string | Publisher forecast status label; not the GovBiz collection health status.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
poc_name | string | Source primary notice point of contact name label; scope is the associated public record, not every procurement at the agency.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
poc_title | string | Source primary notice point of contact published role/title; scope is the associated public record, not every procurement at the agency.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
poc_email | string | Source primary notice point of contact email address; scope is the associated public record, not every procurement at the agency.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
poc_phone | string | Source primary notice point of contact telephone text; scope is the associated public record, not every procurement at the agency.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
published_at | datetime | Publisher publication timestamp when supplied.Storage and value limits: Instant with timezone only if declared; otherwise local/producer time must be explicitly interpreted. Do not invent clock precision. | Values can be missingeq, in, is_null, gte, lte |
source_updated_at | datetime | Publisher update timestamp when supplied; separate from collection time.Storage and value limits: Instant with timezone only if declared; otherwise local/producer time must be explicitly interpreted. Do not invent clock precision. | Values can be missingeq, in, is_null, gte, lte |
Forecast Versions
forecast_versions · Schema 1
One immutable retained forecast version per id, linked by record_id and version_number.
Search modes: structured, lexical. History: Retained observation/version queries.
Measures: record_count. Monetary values use decimal strings with declared units. Unknown amounts do not become zero.
Field definitions and supported filters · 48 fields
| Field | Type / unit | Meaning | Availability and filters |
|---|---|---|---|
id | string | GovBiz surrogate row identifier; interpret together with its relation, not as a source-native key.Storage and value limits: 128-bit identifier; JSON string; does not prove source identity. | Values can be missingeq, in, is_null, contains |
record_id | string | GovBiz source-record row ID connecting immutable versions and observations.Storage and value limits: 128-bit identifier; JSON string; does not prove source identity. | Values can be missingeq, in, is_null, contains |
version_number | integer | Positive sequence number within a source record/version family.Storage and value limits: Signed 32-bit integer; logical domain constraints can be narrower. | Values can be missingeq, in, is_null, gte, lte |
retrieval_id | string | Immutable public source retrieval reference used for evidence.Storage and value limits: 128-bit identifier; JSON string; does not prove source identity. | Values can be missingeq, in, is_null, contains |
parser_version | string | Parser/normalization implementation version used for a stored parse.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
normalized_hash | string | SHA-256 of normalized record content; parser-dependent and distinct from raw bytes.Storage and value limits: Fixed width 64 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |
version_origin | string | Whether a version came from observation, parser reprocessing or manual correction.Storage and value limits: Maximum 24 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |
source_locator | json | Structured evidence locator such as file, sheet, row, page or source field mapping.Storage and value limits: Nested producer-specific structure; no fixed public field contract; redact and project known subfields.File/sheet/row/cell/page location and raw field mapping are evidence; do not use row number as persistent identity. | Values can be missingis_null |
agency_code | string | Stored source agency identifier; namespace can be CGAC, FPDS, top-tier or publisher-specific and must be declared.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ.Every current forecast view agency code is null; organization resolution must be explicit. | Values can be missingeq, in, is_null, contains |
agency_name | string | Source agency name; a label whose scope can be department, bureau or office.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
subagency_code | string | Source bureau/subagency identifier, not automatically the same namespace as agency_code.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
subagency_name | string | Source bureau/subagency label.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
contracting_office_code | string | Source contracting-office identifier; requires an issuer/office namespace.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
contracting_office_name | string | Source contracting-office label.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
fiscal_year | integer | Source/derived US federal fiscal year; October 1 starts the following numbered year, with source-specific precision.Storage and value limits: Signed 32-bit integer; logical domain constraints can be narrower. | Values can be missingeq, in, is_null, gte, lte |
requirement_title | string | Published planned acquisition requirement title.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
requirement_description | string | Publisher description of a planned requirement.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
naics_code | string | Source industry classification code; link with the NAICS edition and declared precision.Storage and value limits: Maximum 12 characters; identifier rules can be narrower.Require a classification edition; do not join broad prefixes as exact identities. | Values can be missingeq, in, is_null, contains |
psc_code | string | Product and Service Code classification; it is not a NAICS industry code.Storage and value limits: Maximum 16 characters; identifier rules can be narrower.Classification overlap is contextual, not record identity. | Values can be missingeq, in, is_null, contains |
estimated_value_min | decimal / USD | Normalized lower endpoint of a publisher acquisition estimate; preserve the original range and open-bound wording.Storage and value limits: Precision 20, scale 2; absolute value below 10^18; rounding on assignment; checks can narrow the range.Current parser converts numeric tokens to min/max and may lose open-bound wording or partial suffixes; retain estimated_value_text. | Values can be missingeq, in, is_null, gte, lte |
estimated_value_max | decimal / USD | Normalized upper endpoint of a publisher acquisition estimate; a range parser can lose open-bound meaning.Storage and value limits: Precision 20, scale 2; absolute value below 10^18; rounding on assignment; checks can narrow the range.Current parser converts numeric tokens to min/max and may lose open-bound wording or partial suffixes; retain estimated_value_text. | Values can be missingeq, in, is_null, gte, lte |
estimated_value_text | string | Original publisher estimate/range text retained for interpretation and provenance.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
estimated_solicitation_date | date | Planned solicitation date; HHS month/year values are currently converted to the first day.Storage and value limits: Calendar date without time of day or timezone; source precision can be month/quarter instead. | Values can be missingeq, in, is_null, gte, lte |
estimated_solicitation_quarter | string | Publisher anticipated solicitation quarter label; do not synthesize an exact day.Storage and value limits: Maximum 12 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |
estimated_award_date | date | Planned award date; month/quarter precision must remain explicit.Storage and value limits: Calendar date without time of day or timezone; source precision can be month/quarter instead. | Values can be missingeq, in, is_null, gte, lte |
estimated_award_quarter | string | Publisher anticipated award quarter label; do not synthesize an exact day.Storage and value limits: Maximum 12 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |
period_of_performance_start | date | Published forecast planned performance start date.Storage and value limits: Calendar date without time of day or timezone; source precision can be month/quarter instead. | Values can be missingeq, in, is_null, gte, lte |
period_of_performance_end | date | Published forecast planned performance end date.Storage and value limits: Calendar date without time of day or timezone; source precision can be month/quarter instead. | Values can be missingeq, in, is_null, gte, lte |
place_of_performance_city | string | Source city of the place of performance; distinct from recipient legal address.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
place_of_performance_state | string | Source state/territory of the place of performance; distinct from recipient legal address.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
place_of_performance_country | string | Source country of the place of performance; distinct from recipient legal address.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
competition_type | string | Publisher planned competition category; not an observed competition outcome.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
set_aside_type | string | Source set-aside label/category; categories and aliases must not be guessed.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
small_business_program | string | Published small-business program label on an acquisition plan.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
acquisition_strategy | string | Publisher acquisition-plan strategy text.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
contract_vehicle | string | Publisher vehicle plan label; not proof of a task-order/parent relationship.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
contract_type | string | Publisher intended contract instrument/pricing category.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
new_or_follow_on | string | Publisher new/follow-on planning label; distinguish from a confirmed predecessor link.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
incumbent_name | string | Publisher named incumbent; a label needing identity resolution.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
incumbent_award_id | string | Publisher incumbent contract reference; qualify by agency/issuer before joining.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
forecast_status | string | Publisher forecast status label; not the GovBiz collection health status.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
poc_name | string | Source primary notice point of contact name label; scope is the associated public record, not every procurement at the agency.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
poc_title | string | Source primary notice point of contact published role/title; scope is the associated public record, not every procurement at the agency.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
poc_email | string | Source primary notice point of contact email address; scope is the associated public record, not every procurement at the agency.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
poc_phone | string | Source primary notice point of contact telephone text; scope is the associated public record, not every procurement at the agency.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
published_at | datetime | Publisher publication timestamp when supplied.Storage and value limits: Instant with timezone only if declared; otherwise local/producer time must be explicitly interpreted. Do not invent clock precision. | Values can be missingeq, in, is_null, gte, lte |
source_updated_at | datetime | Publisher update timestamp when supplied; separate from collection time.Storage and value limits: Instant with timezone only if declared; otherwise local/producer time must be explicitly interpreted. Do not invent clock precision. | Values can be missingeq, in, is_null, gte, lte |
created_at | datetime | GovBiz row/version creation time.Storage and value limits: Instant with timezone only if declared; otherwise local/producer time must be explicitly interpreted. Do not invent clock precision. | Values can be missingeq, in, is_null, gte, lte |
Forecast Changes
forecast_changes · Schema 1
One retained detected forecast field/event change per id, linked by record_id and detected_at; parser-reprocess classification can be incomplete.
Search modes: structured. History: Retained observation/version queries.
Measures: record_count. Monetary values use decimal strings with declared units. Unknown amounts do not become zero.
Field definitions and supported filters · 12 fields
| Field | Type / unit | Meaning | Availability and filters |
|---|---|---|---|
id | string | GovBiz surrogate row identifier; interpret together with its relation, not as a source-native key.Storage and value limits: 128-bit identifier; JSON string; does not prove source identity. | Values can be missingeq, in, is_null, contains |
record_id | string | GovBiz source-record row ID connecting immutable versions and observations.Storage and value limits: 128-bit identifier; JSON string; does not prove source identity. | Values can be missingeq, in, is_null, contains |
from_version_id | string | Previous immutable version involved in a change event.Storage and value limits: 128-bit identifier; JSON string; does not prove source identity. | Values can be missingeq, in, is_null, contains |
to_version_id | string | New immutable version involved in a change event.Storage and value limits: 128-bit identifier; JSON string; does not prove source identity. | Values can be missingeq, in, is_null, contains |
field_name | string | Normalized field whose value changed between immutable versions.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
event_type | string | Relation-specific event category defined by its producer/constraint.Storage and value limits: Maximum 40 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |
old_value | json | Previous normalized field value in its original JSON type.Storage and value limits: Nested producer-specific structure; no fixed public field contract; redact and project known subfields. | Values can be missingis_null |
new_value | json | New normalized field value in its original JSON type.Storage and value limits: Nested producer-specific structure; no fixed public field contract; redact and project known subfields. | Values can be missingis_null |
detected_at | datetime | Time a collector detected a difference between stored observations.Storage and value limits: Instant with timezone only if declared; otherwise local/producer time must be explicitly interpreted. Do not invent clock precision. | Values can be missingeq, in, is_null, gte, lte |
effective_date | date | Intended publisher-effective calendar date of a forecast change; the current change-event insertion does not supply it. detected_at is the observation time, not an inferred effective date.Storage and value limits: Calendar date without time of day or timezone; source precision can be month/quarter instead. | Values can be missingeq, in, is_null, gte, lte |
source_retrieval_id | string | Public retrieval supporting a change event.Storage and value limits: 128-bit identifier; JSON string; does not prove source identity. | Values can be missingeq, in, is_null, contains |
materiality | string | Collector classification of a field change; not monetary materiality by default.Storage and value limits: Maximum 16 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |