GWAC Holders
Contract holders for supported governmentwide and indefinite-delivery acquisition vehicles.
Source, grain and coverage
Public holder lists for supported vehicles. This is not a complete inventory of every federal contract vehicle.
Supported holder lists cover a subset of acquisition vehicles. UEIs, CAGEs, expiration dates and ceiling values can be unavailable. Holder membership does not establish access to every federal IDIQ or current task-order eligibility.
Collection schedule: Weekly.
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/gwac-holders-refresh/records?limit=2' \ -H "Authorization: Bearer $GOVBIZ_API_KEY"
The primary dataset is vehicle_holders. 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 →Vehicle Holders
vehicle_holders · Schema 1
One retained supported vehicle/contract-holder observation per id, rather than a complete federal vehicle inventory.
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 · 19 fields
| Field | Type / unit | Meaning | Availability and filters |
|---|---|---|---|
id | integer | GovBiz surrogate row identifier; interpret together with its relation, not as a source-native key.Storage and value limits: Signed 32-bit integer; logical domain constraints can be narrower. | Values can be missingeq, in, is_null, gte, lte |
vehicle_name | string | Supported GWAC/IDIQ vehicle label; not a globally unique award identifier.Storage and value limits: Maximum 100 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |
contract_number | string | Source contract/holder number; relate with issuer and vehicle context.Storage and value limits: Maximum 100 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |
holder_name | string | Vehicle/rate holder label.Storage and value limits: Maximum 300 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |
holder_uei | string | Source UEI identifying the holder participant; missing/empty values cannot support an exact entity join.Storage and value limits: Maximum 20 characters; identifier rules can be narrower.Logical UEI length is 12; a wider varchar is not broader identity support. | Values can be missingeq, in, is_null, contains |
holder_cage_code | string | Source CAGE identifier for the holder participant; not a UEI.Storage and value limits: Maximum 10 characters; identifier rules can be narrower.CAGE/NCAGE is ordinarily a 5-character code; wider storage is not a source format guarantee. | Values can be missingeq, in, is_null, contains |
is_small_business | boolean | Observed small business source flag; source-code absence/default false is not necessarily a independently verified negative.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 |
naics_codes | array | Source list of industry classifications associated with an entity/agreement/vehicle.Storage and value limits: Array/list; no declared cardinality cap here; distinguish missing list, empty list and per-element nulls.Require a classification edition; do not join broad prefixes as exact identities. | Values can be missingoverlaps, is_null |
sins | array | List of supported Schedule SIN labels on a vehicle record.Storage and value limits: Array/list; no declared cardinality cap here; distinguish missing list, empty list and per-element nulls. | Values can be missingoverlaps, is_null |
award_date | date | Source award date when supplied; the associated source record defines its precision.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 |
expiration_date | date | Published agreement/vehicle/rate expiry when supplied; absent is not perpetual validity.Storage and value limits: Calendar date without time of day or timezone; source precision can be month/quarter instead. | Not collected; returned as unknowneq, in, is_null, gte, lte |
ceiling_value | decimal / USD | Vehicle/contract ceiling when explicitly sourced; a ceiling is not obligated spending.Storage and value limits: Precision 15, scale 2; absolute value below 10^13; rounding on assignment; checks can narrow the range. | Not collected; returned as unknowneq, in, is_null, gte, lte |
status | string | Relation-specific source or operational status; use check constraints where declared and the producer mapping elsewhere.Storage and value limits: Maximum 20 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |
vehicle_type | string | Vehicle instrument/category label.Storage and value limits: Maximum 50 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |
source_url | string | Public provenance URL for the relation record; a generic landing URL is weaker than a record locator.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 |
refreshed_at | datetime | Time a producer refreshed this row; not the underlying source record date.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_small_business_vehicle | boolean | Whether the vehicle is identified as a small-business vehicle; not an entity size determination.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 |
managing_agency | string | Agency administering a contract vehicle; not necessarily the agency buying through it.Storage and value limits: Maximum 50 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |
scrape_status | string | Collector status for the vehicle-list evidence; not the holder contract status.Storage and value limits: Maximum 20 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |