{"ok":true,"site":"usaspending","host":"usaspending.gov","about":"USAspending.gov is the official U.S. federal spending database. This CLI calls its public API (api.usaspending.gov, no auth needed) to search awards and transactions, open award, recipient, agency, state and federal-account profiles, break spending down by category, and request bulk downloads.","commands":[{"command":"search-transactions","summary":"Keyword search of contract transactions (award types A/B/C/D), with sorting and paging","params":[{"name":"keyword","type":"string","required":true,"description":"Free-text keyword to match in transaction and award text"},{"name":"sort","type":"string","description":"Column to sort by","oneOf":["Transaction Amount","Action Date","Award ID","Mod","Recipient Name","Awarding Agency","Awarding Sub Agency","Award Type"],"default":"Transaction Amount"},{"name":"order","type":"string","description":"Sort direction","oneOf":["desc","asc"],"default":"desc"},{"name":"page","type":"number","description":"Page number, starting at 1","default":1},{"name":"api_limit","type":"number","description":"Results per page (max 100) (sent to the site as \"limit\"; clify's own --limit only shapes the output)","default":35}],"exampleUrl":"https://clify-dev.netlify.app/usaspending/search-transactions"},{"command":"count-keyword-transactions","summary":"Count transactions matching a keyword, broken out by award group (contracts, grants, idvs, loans, direct_payments, other)","params":[{"name":"keyword","type":"string","required":true,"description":"Free-text keyword"}],"exampleUrl":"https://clify-dev.netlify.app/usaspending/count-keyword-transactions"},{"command":"summarize-keyword-spending","summary":"Total prime award count and obligated amount for a keyword search","params":[{"name":"keyword","type":"string","required":true,"description":"Free-text keyword"}],"exampleUrl":"https://clify-dev.netlify.app/usaspending/summarize-keyword-spending"},{"command":"search-state-awards","summary":"Top contract awards performed in a U.S. state within a date range, sorted by award amount","params":[{"name":"state","type":"string","required":true,"description":"Two-letter state code of the place of performance"},{"name":"start_date","type":"string","description":"Start of the action-date range, YYYY-MM-DD (not earlier than 2007-10-01)","default":"2025-10-01"},{"name":"end_date","type":"string","description":"End of the action-date range, YYYY-MM-DD","default":"2026-09-30"},{"name":"order","type":"string","description":"Sort direction on Award Amount","oneOf":["desc","asc"],"default":"desc"},{"name":"page","type":"number","description":"Page number","default":1},{"name":"api_limit","type":"number","description":"Results per page (max 100) (sent to the site as \"limit\"; clify's own --limit only shapes the output)","default":10}],"exampleUrl":"https://clify-dev.netlify.app/usaspending/search-state-awards"},{"command":"list-federal-account-awards","summary":"Contract awards funded by a federal account (agency id + main account code), sorted by award amount","params":[{"name":"aid","type":"string","required":true,"description":"Agency identifier: the first part of the federal account number, e.g. 017 in 017-1804"},{"name":"main","type":"string","required":true,"description":"Main account code: the second part of the federal account number, e.g. 1804"},{"name":"order","type":"string","description":"Sort direction on Award Amount","oneOf":["desc","asc"],"default":"desc"},{"name":"page","type":"number","description":"Page number","default":1},{"name":"api_limit","type":"number","description":"Results per page (max 100) (sent to the site as \"limit\"; clify's own --limit only shapes the output)","default":10}],"exampleUrl":"https://clify-dev.netlify.app/usaspending/list-federal-account-awards"},{"command":"get-award","summary":"Full details of one award: amounts, dates, parent IDV, recipient, place of performance, contract data","params":[{"name":"award_id","type":"string","required":true,"description":"Generated unique award id (generated_internal_id from search results), e.g. CONT_AWD_..._..."}],"exampleUrl":"https://clify-dev.netlify.app/usaspending/get-award"},{"command":"count-award-children","summary":"Count an award's transactions, subawards, or funding federal accounts","params":[{"name":"kind","type":"string","required":true,"description":"What to count","oneOf":["transaction","subaward","federal_account"]},{"name":"award_id","type":"string","required":true,"description":"Generated unique award id"}],"exampleUrl":"https://clify-dev.netlify.app/usaspending/count-award-children"},{"command":"list-award-federal-accounts","summary":"Federal accounts that funded an award, with obligated amounts and funding agency","params":[{"name":"award_id","type":"string","required":true,"description":"Generated unique award id"},{"name":"page","type":"number","description":"Page number","default":1},{"name":"api_limit","type":"number","description":"Results per page (sent to the site as \"limit\"; clify's own --limit only shapes the output)","default":100}],"exampleUrl":"https://clify-dev.netlify.app/usaspending/list-award-federal-accounts"},{"command":"get-recipient","summary":"Recipient profile: name, UEI/DUNS, parents, business types, location, and transaction totals for a year","params":[{"name":"recipient_id","type":"string","required":true,"description":"Recipient hash id with level suffix (-C child, -P parent, -R recipient), e.g. fefa9485-...-C"},{"name":"year","type":"string","description":"Fiscal year (e.g. 2026), 'latest' (trailing 12 months) or 'all'","default":"latest"}],"exampleUrl":"https://clify-dev.netlify.app/usaspending/get-recipient"},{"command":"recipient-spending-by-category","summary":"Top breakdown of a recipient's obligations by agency, sub-agency, NAICS, PSC, CFDA, federal account, country or state","params":[{"name":"category","type":"string","required":true,"description":"Dimension to group by","oneOf":["awarding_agency","awarding_subagency","naics","psc","cfda","federal_account","country","state_territory"]},{"name":"recipient_id","type":"string","required":true,"description":"Recipient hash id with level suffix"},{"name":"start_date","type":"string","description":"Start date, YYYY-MM-DD","default":"2025-10-18"},{"name":"end_date","type":"string","description":"End date, YYYY-MM-DD","default":"2026-10-18"},{"name":"page","type":"number","description":"Page number","default":1},{"name":"api_limit","type":"number","description":"Results per page (sent to the site as \"limit\"; clify's own --limit only shapes the output)","default":5}],"exampleUrl":"https://clify-dev.netlify.app/usaspending/recipient-spending-by-category"},{"command":"recipient-spending-over-time","summary":"A recipient's obligations per fiscal year, quarter or month, split by award type","params":[{"name":"recipient_id","type":"string","required":true,"description":"Recipient hash id with level suffix"},{"name":"group","type":"string","description":"Time bucket","oneOf":["fiscal_year","quarter","month"],"default":"fiscal_year"},{"name":"start_date","type":"string","description":"Start date, YYYY-MM-DD (not earlier than 2007-10-01)","default":"2007-10-01"},{"name":"end_date","type":"string","description":"End date, YYYY-MM-DD","default":"2027-09-30"}],"exampleUrl":"https://clify-dev.netlify.app/usaspending/recipient-spending-over-time"},{"command":"recipient-new-awards-over-time","summary":"Count of new awards to a recipient per fiscal year, quarter or month","params":[{"name":"recipient_id","type":"string","required":true,"description":"Recipient hash id with level suffix"},{"name":"group","type":"string","description":"Time bucket","oneOf":["fiscal_year","quarter","month"],"default":"fiscal_year"},{"name":"start_date","type":"string","description":"Start date, YYYY-MM-DD","default":"2007-10-01"},{"name":"end_date","type":"string","description":"End date, YYYY-MM-DD","default":"2027-09-30"}],"exampleUrl":"https://clify-dev.netlify.app/usaspending/recipient-new-awards-over-time"},{"command":"get-state-profile","summary":"State spending profile: population, income, total prime award amount and count, per-capita amount","params":[{"name":"fips","type":"string","required":true,"description":"Two-digit state FIPS code (see list-states), e.g. 06 for California"},{"name":"year","type":"string","description":"Fiscal year (e.g. 2026), 'latest' or 'all'","default":"latest"}],"exampleUrl":"https://clify-dev.netlify.app/usaspending/get-state-profile?year=2026"},{"command":"get-state-awards-by-type","summary":"A state's prime award amounts and counts by award type (contracts, grants, loans, direct payments, other)","params":[{"name":"fips","type":"string","required":true,"description":"Two-digit state FIPS code"},{"name":"year","type":"string","description":"Fiscal year, 'latest' or 'all'","default":"latest"}],"exampleUrl":"https://clify-dev.netlify.app/usaspending/get-state-awards-by-type"},{"command":"state-spending-by-category","summary":"Top breakdown of spending performed in a state by recipient, county, congressional district, agency, NAICS, PSC or CFDA","params":[{"name":"category","type":"string","required":true,"description":"Dimension to group by","oneOf":["recipient","county","district","awarding_agency","awarding_subagency","naics","psc","cfda"]},{"name":"state","type":"string","required":true,"description":"Two-letter state code of the place of performance"},{"name":"start_date","type":"string","description":"Start date, YYYY-MM-DD","default":"2025-10-18"},{"name":"end_date","type":"string","description":"End date, YYYY-MM-DD","default":"2026-10-18"},{"name":"page","type":"number","description":"Page number","default":1},{"name":"api_limit","type":"number","description":"Results per page (sent to the site as \"limit\"; clify's own --limit only shapes the output)","default":5}],"exampleUrl":"https://clify-dev.netlify.app/usaspending/state-spending-by-category"},{"command":"state-spending-over-time","summary":"Transaction obligations performed in a state per fiscal year, quarter or month","params":[{"name":"state","type":"string","required":true,"description":"Two-letter state code"},{"name":"group","type":"string","description":"Time bucket","oneOf":["fiscal_year","quarter","month"],"default":"fiscal_year"},{"name":"start_date","type":"string","description":"Start date, YYYY-MM-DD","default":"2007-10-01"},{"name":"end_date","type":"string","description":"End date, YYYY-MM-DD","default":"2027-09-30"}],"exampleUrl":"https://clify-dev.netlify.app/usaspending/state-spending-over-time"},{"command":"state-spending-by-geography","summary":"Map data: spending in a state per county or congressional district, with population and per-capita amount","params":[{"name":"state","type":"string","required":true,"description":"Two-letter state code"},{"name":"geo_layer","type":"string","description":"Geographic unit to aggregate by","oneOf":["county","district"],"default":"county"},{"name":"scope","type":"string","description":"Location type to aggregate on","oneOf":["place_of_performance","recipient_location"],"default":"place_of_performance"},{"name":"start_date","type":"string","description":"Start date, YYYY-MM-DD","default":"2025-10-18"},{"name":"end_date","type":"string","description":"End date, YYYY-MM-DD","default":"2026-10-18"}],"exampleUrl":"https://clify-dev.netlify.app/usaspending/state-spending-by-geography"},{"command":"list-agencies","summary":"All top-tier federal agencies with toptier_code, slug, budget authority, obligations and outlays","params":[{"name":"sort","type":"string","description":"Sort field","oneOf":["percentage_of_total_budget_authority","agency_name","budget_authority_amount","obligated_amount","outlay_amount","active_fy"],"default":"percentage_of_total_budget_authority"},{"name":"order","type":"string","description":"Sort direction","oneOf":["desc","asc"],"default":"desc"}],"exampleUrl":"https://clify-dev.netlify.app/usaspending/list-agencies?sort=agency_name&order=asc"},{"command":"get-agency","summary":"Agency overview for a fiscal year: name, mission, website, sub-tier count, disaster codes","params":[{"name":"toptier_code","type":"string","required":true,"description":"3- or 4-digit agency toptier code (see list-agencies), e.g. 097 for DOD"},{"name":"fiscal_year","type":"number","description":"Fiscal year (Oct-Sep)","default":2026}],"exampleUrl":"https://clify-dev.netlify.app/usaspending/get-agency?fiscal_year=2026"},{"command":"get-agency-award-summary","summary":"An agency's award transaction count, total obligations and latest action date for a fiscal year","params":[{"name":"toptier_code","type":"string","required":true,"description":"Agency toptier code"},{"name":"fiscal_year","type":"number","description":"Fiscal year","default":2026}],"exampleUrl":"https://clify-dev.netlify.app/usaspending/get-agency-award-summary?fiscal_year=2026"},{"command":"get-agency-new-award-count","summary":"Number of new awards an agency made in a fiscal year","params":[{"name":"toptier_code","type":"string","required":true,"description":"Agency toptier code"},{"name":"fiscal_year","type":"number","description":"Fiscal year","default":2026}],"exampleUrl":"https://clify-dev.netlify.app/usaspending/get-agency-new-award-count?fiscal_year=2026"},{"command":"get-agency-obligations-by-category","summary":"An agency's award obligations for a fiscal year split by category (contracts, grants, loans, ...)","params":[{"name":"toptier_code","type":"string","required":true,"description":"Agency toptier code"},{"name":"fiscal_year","type":"number","description":"Fiscal year","default":2026}],"exampleUrl":"https://clify-dev.netlify.app/usaspending/get-agency-obligations-by-category?fiscal_year=2026"},{"command":"list-agency-sub-agencies","summary":"An agency's sub-agencies and their offices, with obligations, transaction counts and new award counts","params":[{"name":"toptier_code","type":"string","required":true,"description":"Agency toptier code"},{"name":"fiscal_year","type":"number","description":"Fiscal year","default":2026},{"name":"sort","type":"string","description":"Sort field","oneOf":["total_obligations","name","transaction_count","new_award_count"],"default":"total_obligations"},{"name":"order","type":"string","description":"Sort direction","oneOf":["desc","asc"],"default":"desc"},{"name":"page","type":"number","description":"Page number","default":1},{"name":"api_limit","type":"number","description":"Results per page (sent to the site as \"limit\"; clify's own --limit only shapes the output)","default":10}],"exampleUrl":"https://clify-dev.netlify.app/usaspending/list-agency-sub-agencies?fiscal_year=2026"},{"command":"list-agency-sub-components","summary":"An agency's budgetary sub-components (bureaus) with obligations, outlays and budgetary resources","params":[{"name":"toptier_code","type":"string","required":true,"description":"Agency toptier code"},{"name":"fiscal_year","type":"number","description":"Fiscal year","default":2026},{"name":"page","type":"number","description":"Page number","default":1}],"exampleUrl":"https://clify-dev.netlify.app/usaspending/list-agency-sub-components?fiscal_year=2026"},{"command":"get-agency-budgetary-resources","summary":"An agency's budgetary resources, obligations and outlays per fiscal year, with obligations by period","params":[{"name":"toptier_code","type":"string","required":true,"description":"Agency toptier code"}],"exampleUrl":"https://clify-dev.netlify.app/usaspending/get-agency-budgetary-resources"},{"command":"list-federal-accounts","summary":"List or keyword-search federal (Treasury) accounts for a fiscal year, sorted by budgetary resources","params":[{"name":"keyword","type":"string","description":"Text to match in account name, number or agency"},{"name":"fy","type":"string","description":"Fiscal year","default":"2026"},{"name":"sort","type":"string","description":"Sort field","oneOf":["budgetary_resources","account_name","account_number","managing_agency"],"default":"budgetary_resources"},{"name":"direction","type":"string","description":"Sort direction","oneOf":["desc","asc"],"default":"desc"},{"name":"page","type":"number","description":"Page number","default":1},{"name":"api_limit","type":"number","description":"Results per page (sent to the site as \"limit\"; clify's own --limit only shapes the output)","default":50}],"exampleUrl":"https://clify-dev.netlify.app/usaspending/list-federal-accounts"},{"command":"get-federal-account","summary":"Federal account details by account number (agency-main, e.g. 017-1804): title, parent agency, bureau, totals and child Treasury accounts for a fiscal year","params":[{"name":"account_number","type":"string","required":true,"description":"Federal account number in AAA-MMMM form"},{"name":"fiscal_year","type":"number","description":"Fiscal year (Oct-Sep) for totals and children; without it the API uses the latest year, which may still be empty","default":2026}],"exampleUrl":"https://clify-dev.netlify.app/usaspending/get-federal-account?fiscal_year=2026"},{"command":"get-federal-account-fy-snapshot","summary":"A federal account's budgetary resources, obligations, outlays and balances for one fiscal year","params":[{"name":"account_id","type":"number","required":true,"description":"Numeric federal account id (account_id from list-federal-accounts)"},{"name":"fiscal_year","type":"number","required":true,"description":"Fiscal year"}],"exampleUrl":"https://clify-dev.netlify.app/usaspending/get-federal-account-fy-snapshot"},{"command":"request-award-download","summary":"Start a bulk CSV download job of prime award transactions matching a keyword; returns file_name for get-download-status","params":[{"name":"keyword","type":"string","required":true,"description":"Free-text keyword"}],"exampleUrl":"https://clify-dev.netlify.app/usaspending/request-award-download"},{"command":"get-download-status","summary":"Check a bulk download job; when status is 'ready', file_url points to the zip","params":[{"name":"file_name","type":"string","required":true,"description":"file_name returned by request-award-download"}],"exampleUrl":"https://clify-dev.netlify.app/usaspending/get-download-status?file_name=PrimeTransactions_2026-10-18_H07M18S08454046.zip"},{"command":"autocomplete-awarding-agency","summary":"Find awarding agencies and sub-agencies by partial name","params":[{"name":"search_text","type":"string","required":true,"description":"Partial agency name"},{"name":"api_limit","type":"number","description":"Max results (sent to the site as \"limit\"; clify's own --limit only shapes the output)","default":20}],"exampleUrl":"https://clify-dev.netlify.app/usaspending/autocomplete-awarding-agency"},{"command":"list-states","summary":"States and territories with FIPS code, postal code and name (FIPS is used by the state profile commands)","params":[],"exampleUrl":"https://clify-dev.netlify.app/usaspending/list-states"},{"command":"list-def-codes","summary":"Disaster Emergency Fund (DEFC) codes with public law, title and disaster type","params":[],"exampleUrl":"https://clify-dev.netlify.app/usaspending/list-def-codes"},{"command":"list-glossary","summary":"USAspending glossary of spending terms with plain-language and official definitions","params":[{"name":"api_limit","type":"number","description":"Max terms to return (sent to the site as \"limit\"; clify's own --limit only shapes the output)","default":500}],"exampleUrl":"https://clify-dev.netlify.app/usaspending/list-glossary"}]}