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.
View input schema
{
"type": "object",
"properties": {
"award_type": {
"default": "contracts",
"enum": [
"contracts",
"idvs",
"grants",
"loans",
"direct_payments",
"other"
],
"title": "Award Type",
"type": "string"
},
"keywords": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Keywords"
},
"awarding_agency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Awarding Agency"
},
"awarding_subagency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Awarding Subagency"
},
"funding_agency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Funding Agency"
},
"recipient_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Recipient Name"
},
"naics_codes": {
"anyOf": [
{
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
]
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Naics Codes"
},
"psc_codes": {
"anyOf": [
{
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
]
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Psc Codes"
},
"set_aside_type_codes": {
"anyOf": [
{
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
]
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Set Aside Type Codes"
},
"extent_competed_type_codes": {
"anyOf": [
{
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
]
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Extent Competed Type Codes"
},
"contract_pricing_type_codes": {
"anyOf": [
{
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
]
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Contract Pricing Type Codes"
},
"time_period_start": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Time Period Start"
},
"time_period_end": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Time Period End"
},
"date_type": {
"anyOf": [
{
"enum": [
"action_date",
"date_signed",
"last_modified_date",
"new_awards_only"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Date Type"
},
"award_amount_min": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Award Amount Min"
},
"award_amount_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Award Amount Max"
},
"place_of_performance_state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Place Of Performance State"
},
"def_codes": {
"anyOf": [
{
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
]
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Def Codes"
},
"program_numbers": {
"anyOf": [
{
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
]
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Program Numbers"
}
},
"title": "get_award_countArguments"
}