# USAspending API: Get agency spending

> Gets a federal agency's fiscal-year budgetary resources, obligations, share of federal obligations, new award count, top recipients and spending classes from USAspending.

Unofficial. Not affiliated with or endorsed by USAspending.

- Page: https://fous.com/methods/usaspending.gov/get-agency-spending
- Method: `usaspending.gov/get_agency_spending`, version 1
- Website: usaspending.gov
- Returns: budgetary resources, obligations, share of federal obligations, award count, top recipients, top spending categories, data date
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `agency` | string | yes | `"EPA"` | Federal agency name or common abbreviation, for example NASA or Department of Defense. |
| `fiscal_year` | integer | no |  | Federal fiscal year, for example 2025. Defaults to the latest year with agency data. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "agency": "EPA"
}
```

Its output:

```json
{
  "as_of_date": "2026-10-23",
  "agency_code": "068",
  "agency_link": "https://www.usaspending.gov/agency/environmental-protection-agency",
  "agency_name": "Environmental Protection Agency",
  "fiscal_year": 2026,
  "top_recipients": [
    {
      "name": "FLORIDA DEPARTMENT OF ENVIRONMENTAL PROTECTION",
      "page_link": "https://www.usaspending.gov/recipient/ae3e08de-48a4-ddbd-7a58-53e1fb14742f-C/latest",
      "amount_usd": 2007463505
    },
    {
      "name": "THE STATE OF OHIO OFFICE OF BUDGET AND MANAGEMENT",
      "page_link": "https://www.usaspending.gov/recipient/615ca93b-904d-c303-bd34-715393928147-C/latest",
      "amount_usd": 813141191
    },
    {
      "name": "ILLINOIS ENVIRONMENTAL PROTECTION AGENCY",
      "page_link": "https://www.usaspending.gov/recipient/fc0efc9e-c129-b96b-fa39-cfefcb2eb204-C/latest",
      "amount_usd": 705470519
    }
  ],
  "number_of_awards": 3579,
  "total_obligations_usd": 21215321918.57,
  "top_spending_categories": [
    {
      "name": "Grants, subsidies, and contributions",
      "page_link": "https://www.usaspending.gov/agency/environmental-protection-agency",
      "amount_usd": 14628663614.36
    },
    {
      "name": "Other services from non-Federal sources",
      "page_link": "https://www.usaspending.gov/agency/environmental-protection-agency",
      "amount_usd": 2267884750.52
    },
    {
      "name": "Full-time permanent",
      "page_link": "https://www.usaspending.gov/agency/environmental-protection-agency",
      "amount_usd": 1652459740.32
    }
  ],
  "total_budgetary_resources_usd": 56866106074.7,
  "share_of_federal_obligations_percent": 0.2139
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"usaspending.gov/get_agency_spending","input":{"agency":"EPA"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- How much budget did NASA have available and how much did it obligate in fiscal year 2025?
- What share of total federal obligations went to the Department of Defense in FY 2024, and who were its top recipients?
- Show me the number of new awards the VA made last fiscal year along with its biggest spending categories on usaspending.gov.
- Pull up the Department of Energy's budgetary resources and obligations for fiscal 2023, including the data date.
- Which companies received the most money from the Department of Health and Human Services in 2025, and what were the main spending classes?

## Input schema

```json
{
  "type": "object",
  "required": [
    "agency"
  ],
  "properties": {
    "agency": {
      "type": "string",
      "description": "Federal agency name or common abbreviation, for example NASA or Department of Defense."
    },
    "fiscal_year": {
      "type": "integer",
      "description": "Federal fiscal year, for example 2025. Defaults to the latest year with agency data."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "agency_name",
    "fiscal_year",
    "total_budgetary_resources_usd",
    "total_obligations_usd",
    "number_of_awards",
    "top_recipients",
    "top_spending_categories",
    "as_of_date",
    "agency_link",
    "agency_code"
  ],
  "properties": {
    "as_of_date": {
      "type": "string"
    },
    "agency_code": {
      "type": "string"
    },
    "agency_link": {
      "type": "string"
    },
    "agency_name": {
      "type": "string"
    },
    "fiscal_year": {
      "type": "integer"
    },
    "top_recipients": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "page_link": {
            "type": [
              "string",
              "null"
            ]
          },
          "amount_usd": {
            "type": "number"
          }
        }
      }
    },
    "number_of_awards": {
      "type": "integer"
    },
    "total_obligations_usd": {
      "type": "number"
    },
    "top_spending_categories": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "page_link": {
            "type": [
              "string",
              "null"
            ]
          },
          "amount_usd": {
            "type": "number"
          }
        }
      }
    },
    "total_budgetary_resources_usd": {
      "type": "number"
    },
    "share_of_federal_obligations_percent": {
      "type": "number"
    }
  }
}
```

## See more

- [USAspending API: Get company federal awards](https://fous.com/methods/usaspending.gov/get-company-federal-awards.md): Returns federal obligations and distinct awards for a company or organization, including its parent and child recipient records. Covers the selected fiscal year or the last five fiscal years.
- [USAspending API: Search federal awards](https://fous.com/methods/usaspending.gov/search-federal-awards.md): Searches USAspending federal awards by keywords, awarding agency, state of performance and date across contracts, grants, loans and direct payments. Searches from October 1, 2007 onward.
- [Grants.gov API: Search grant opportunities](https://fous.com/methods/grants.gov/search-grants.md): Finds U.S. federal grant opportunities by topic, agency, applicant type and status, with funding and eligibility details. Open results exclude opportunities whose closing date has passed.
- [USAJOBS API: Search federal jobs](https://fous.com/methods/usajobs.gov/search-jobs.md): Searches USAJOBS federal jobs by keywords, location, salary threshold and applicant group, in website relevance order. Salary ranges may start below the threshold; annual pay or remote status is null when the announcement does not state it.
- [NIH API: Search grants](https://fous.com/methods/reporter.nih.gov/search-grants.md): Finds NIH research grants by topic, organisation, or researcher name. Searches the last five fiscal years by default.
- [U.S. Treasury API: Get national debt](https://fous.com/methods/home.treasury.gov/get-national-debt.md): Returns US national debt (Debt to the Penny) for a given date, or the latest published day. Dates without a record use the previous published day.
- [SAM.gov API: Search contract opportunities](https://fous.com/methods/sam.gov/search-contract-opportunities.md): Finds active federal contract notices on SAM.gov that match keywords, agency, place of performance, set-aside, notice type and posting period.
- [Federal Register API: Search rules and notices](https://fous.com/methods/federalregister.gov/search-rules.md): Find Federal Register rules, proposed rules, notices, and presidential documents by topic, agency, publication dates, and comment status. Significant means designated significant by the source; documents without that designation show no.
- [All USAspending methods](https://fous.com/methods/usaspending.gov.md)
