US Federal Contract Awards & Suppliers

A free, normalized daily dataset of newly reported or updated United States federal prime contract awards and their suppliers. WebTruffle builds each edition from the official USAspending.gov API and publishes aggregation-safe award summaries plus supplier and award-to-supplier relationship tables.

Each edition is a three-day, inclusive rolling window on the source record's last_modified_at date. The public dataset contains prime contract awards with a base_action_date on or after 2022-04-04. It is a change-window product, not a complete inventory of all active contracts or a transaction ledger.

Download the latest edition

No account or API key is required.

Product	Format	Download	Grain
Awards	CSV	us-federal-contract-awards.csv	One current award summary per USAspending award ID in the edition
Awards	JSON	us-federal-contract-awards.json	Same award records as a JSON array
Awards	JSONL	us-federal-contract-awards.jsonl	Same award records, one JSON object per line
Suppliers	CSV	suppliers.csv	One normalized prime supplier identity per edition
Suppliers	JSONL	suppliers.jsonl	Same supplier records, one JSON object per line
Award suppliers	CSV	award-suppliers.csv	One award-to-prime-supplier relationship
Award suppliers	JSONL	award-suppliers.jsonl	Same relationships, one JSON object per line

Every release also includes:

Asset	Purpose
manifest.json	Edition metadata, record counts, file sizes, and SHA-256 checksums
source-health.json	Source request status, raw validation counts, and publication diagnostics
schema.json	Machine-readable field definitions and product grains
data-dictionary.json	Field-level descriptions and source mappings
known-gaps.json	Machine-readable coverage and interpretation caveats

Browse all editions or read the dataset page.

What an edition contains

The collector requests USAspending prime award types A, B, C, and D using last_modified_date as the source date type. For a release dated D, the inclusive source window is D-2 through D. Records are deduplicated by USAspending's generated award identifier, and the newest summary returned for that identifier is published.

The raw source count is validated before the public 2022-04-04 base-action-date cutoff is applied. The overlap helps recover late-arriving or revised source records. It also means the same award can appear in adjacent editions. Do not sum award values across releases without first deduplicating by award_id and choosing the desired snapshot.

The three products are:

• us-federal-contract-awards.*: the main, one-award product and the canonical grain for aggregating award amounts within one edition.
• suppliers.*: one supplier identity per edition, with award counts and cumulative obligated amounts calculated from that edition's award rows.
• award-suppliers.*: the explicit link from each award to its prime supplier. This product does not represent subcontractors.

Supplier identity

Supplier keys use only explicit identifiers from the source. Identity priority is Unique Entity Identifier (UEI), then the government-issued Commercial and Government Entity (CAGE) code, then a deterministic award-scoped unresolved key. The final fallback keeps every award linkable without guessing that two similarly named recipients are the same organization.

Recipient names are retained as labels and variants, not used for fuzzy entity matching. An award-scoped unresolved supplier must not be treated as the same organization as an unresolved supplier on another award.

Amounts are not interchangeable

All amount fields are denominated in USD, but they answer different questions:

• total_obligated_amount_usd is the cumulative amount the government has legally committed on the award as of the source snapshot. It is not a cash payment.
• total_outlay_amount_usd is cumulative cash disbursed against the award when USAspending reports it.
• current_total_value_of_award_usd is the current procurement value, including the base and exercised options.
• potential_total_value_of_award_usd is the possible value if all available options are exercised. It is a ceiling or potential value, not committed spending.

A reported zero is preserved as a canonical zero-valued decimal string. A missing amount remains null or an empty CSV cell; it is never silently converted to zero. Supplier obligation totals expose obligation_amount_award_count so users can see how many award rows contributed a non-null amount.

Explicit exclusions

This public v1 dataset does not include:

• indefinite-delivery vehicles (IDVs) as their own award product;
• subawards or subcontractors;
• individual transaction or contract-action rows;
• contract opportunities or solicitations from SAM.gov;
• contact people, email addresses, telephone/fax numbers, or recipient street addresses;
• officer-compensation data; or
• DUNS identifiers, D&B-derived business names or locations, parent/DBA fields, or other legacy D&B data.

CAGE codes are government-issued identifiers and are not DUNS identifiers or D&B-derived legacy fields.

Source timing and coverage

USAspending data is updated after its source pipelines run, and source agencies can revise award summaries. Federal contract actions are generally reported within three business days, while Department of Defense and U.S. Army Corps of Engineers records can be withheld from public display for up to 90 days. A recently signed contract can therefore appear in a much later edition, where its base_action_date is older than its last_modified_at date.

An absent award does not prove that no award exists. It can mean the source has not published it yet, its latest modification fell outside the edition window, it predates the public cutoff, or it belongs to an excluded product type.

Publishing and traceability

The pipeline runs daily and targets the preceding completed source day in the America/New_York time zone. A successful publication uses a YYYY-MM-DD GitHub Release tag. A corrected edition uses a revision tag such as YYYY-MM-DD-r2, preserving the earlier release.

Asset names remain constant across releases. Dataset files are GitHub Release assets rather than daily Git commits. Use manifest.json to pin an edition and verify byte sizes and SHA-256 checksums. See SCHEMA.md for the exact public fields and SOURCE_NOTICES.md for attribution, source terms, and caveats.

Reuse

WebTruffle does not apply a blanket CC0 declaration to this dataset. Source terms remain applicable. Each award preserves an official source permalink and a source-terms URL. Review SOURCE_NOTICES.md before reuse.

Need deeper coverage?

WebTruffle builds dependable public-data collection and delivery systems. If this free edition is close to what you need, get in touch for longer history, transaction-level delivery, IDV and order relationships, tailored agency/NAICS/PSC qualification, alerts, or a custom API.