Interpretation limit
Do not add a total to its transactions or equate obligation, payment and loan face value.
Public sources / US
Explore published US federal spending, contract and assistance award data.

AI-generated illustration
Read this source in practice
Except for loans, the guide distinguishes obligations, spending commitments, from outlays, payments made.

AI-generated illustration
Do not add a total to its transactions or equate obligation, payment and loan face value.
Award identifier, file type, measure, period and retained adjustments.
A fictional obligation of 100 is reduced by 20; outlays are 30. The net 80 obligated is not 80 paid.
Consulted reference : USAspending — Federal Spending Guide, 26 April 2023 · Consulted on
Updated on :
The reference documents the reading method. The example is fictional; this note does not attest a portal test today or a mission outcome.
Identify producer, series code, dimensions and revisions. Different portals may distribute one observation without a new collection.
Explore published US federal spending, contract and assistance award data.
Check definitions, reporting thresholds, corrections and lag before comparing amounts.
Award ID, agency, recipient, fiscal year, amount type, exported file or search and extraction date.
Account and award data have different scopes; distinguish obligations from outlays.
Access, download and API conditions depend on the service. Consult the official documentation and the resource terms.
Start from the notice, seek an award in published spending and consult EDGAR only where the issuer is relevant.
Notices, awards, payments and company disclosures differ in scope; do not merge by name alone.
Compare sourcesInspect the exact resource and its terms. Being viewable does not authorise redistribution; retain the resource licence and restrictions instead of inferring them from the portal.
Record consultation date, covered period, last update and version separately. For revised data, retain the file or exact extraction reference.
The web page, export and API may differ in coverage or terms. Check pagination, filters, authentication, quotas and licence for the access method used.
Only when the definition allows it. Missing, confidential, inapplicable and observed zero must remain distinct. Retain status codes.
Check recipient, funding identifier, period, currency and amount type. One project may appear in several systems; reconcile records before summing.
Compare and convert public amountsDOCUMENTED REFERENCE
The Federal Spending Guide separates prime awards, their transactions and sub-awards. A transaction may create or modify an award. A summary rolls up related transactions; these rows are not independent amounts to add together.
| Reference | Value or form | What it identifies |
|---|---|---|
| contract_award_unique_key | Contract | Prime award key used in contract transaction and summary files. |
| assistance_award_unique_key | Assistance | Prime award key for financial assistance; do not replace it with the recipient’s name alone. |
| federal_action_obligation | Transaction | Obligation for the action in a transaction; a negative value can reduce a previous obligation. |
| total_obligated_amount | Award | Award’s total obligation, also present in some transaction files; a repeated total is not additional spending. |
| sub-award | Prime → sub | Agreement by the prime recipient with another entity for part of the work, distinct from the initial federal agreement. |
Choose transaction, award or sub-award level first. Check file type, identifier and period. Do not add summaries to their transactions or sub-awards to prime amounts as extra federal funds. Loans use a distinct subsidy-cost measure.
No: one recipient may have several awards, each with several transactions. Joining on name alone can multiply rows. Compare distinct keys before and after, then reconcile at the chosen level without summing repeated totals.
Documentation consulted on .
DEEPER READING / PRACTICE
A list indicates where to look for and what limits to keep in mind. It helps to prepare a consultation but does not replace the reading of the obtained document.
Updated on .
Select a precise question, open the source and raise the request, result and date. Compare the possibilities announced with the information actually available at the time of the consultation.
The availability of a service and its content may vary. The directory does not turn an absent, partial or ambiguous result into a definitive response.
The consultation report documentes the search path, document found, useful elements and reserves. The result is included in the file with its origin.