get_award_count
Read-only
Count awards matching filters, broken down by award category.
Returns counts grouped by: contracts, idvs, grants, loans, direct_payments, other.
Use this for dimensional analysis: how many FFP vs T&M awards, how many
competed vs sole-source, how many small business set-asides, etc.
Unlike search_awards, this returns total counts across ALL award categories
in a single call (not just the one specified in award_type). The award_type
parameter is ignored here; filters apply to the count query directly.
def_codes filters to Disaster Emergency Fund codes; see
get_def_codes_reference().
At least one filter is required (the API rejects empty filter sets with HTTP 400).
Typical usage: pass time_period_start + time_period_end, or a keywords/agency filter.
date_type controls the award date window. Omitted (the default),
the latest action must be on/after the window start and the first signing
on/before its end. This interval overlap does NOT prove an action occurred
inside the window. For actual dated actions use spending_by_transaction,
read every page, and deduplicate award identifiers for distinct awards;
get_transactions provides a discovered award's complete action history.
'action_date' bounds the latest action, not any action; 'date_signed'
bounds first signing; 'last_modified_date' bounds the latest update.
'new_awards_only' keeps awards first signed in the window.
date_type needs time_period_start and/or time_period_end.
program_numbers filters assistance awards by assistance listing (CFDA)
number, e.g. ['93.778'] for Medicaid; use it with award_type='grants',
'loans', 'direct_payments', or 'other'. autocomplete_cfda() finds numbers
by program name.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| keywords | No | ||
| date_type | No | ||
| def_codes | No | ||
| psc_codes | No | ||
| award_type | No | contracts | |
| naics_codes | No | ||
| funding_agency | No | ||
| recipient_name | No | ||
| awarding_agency | No | ||
| program_numbers | No | ||
| time_period_end | No | ||
| award_amount_max | No | ||
| award_amount_min | No | ||
| time_period_start | No | ||
| awarding_subagency | No | ||
| set_aside_type_codes | No | ||
| extent_competed_type_codes | No | ||
| place_of_performance_state | No | ||
| contract_pricing_type_codes | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||