Skip to main content
Glama

USASpending.gov

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
NameRequiredDescriptionDefault
keywordsNo
date_typeNo
def_codesNo
psc_codesNo
award_typeNocontracts
naics_codesNo
funding_agencyNo
recipient_nameNo
awarding_agencyNo
program_numbersNo
time_period_endNo
award_amount_maxNo
award_amount_minNo
time_period_startNo
awarding_subagencyNo
set_aside_type_codesNo
extent_competed_type_codesNo
place_of_performance_stateNo
contract_pricing_type_codesNo

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.