USAspending API ReferenceIndependent
Try the API

Spending By Transaction Count

POST/api/v2/search/spending_by_transaction_count/
Powers Keyword search on usaspending.gov

Returns the counts of transaction records which match the keyword grouped by award categories.

Request

curl -X POST 'https://api.usaspending.gov/api/v2/search/spending_by_transaction_count/' \
  -H 'Content-Type: application/json' \
  -d '{
  "filters": {
    "keywords": [
      "test"
    ],
    "award_type_codes": [
      "A",
      "B",
      "C",
      "D"
    ]
  }
}'

Request body

The filters object is shared by every search endpoint. The filter object explains each filter with examples.

  • filtersobject · AdvancedFilterObjectRequired

    The filters available are defined in AdvancedFilterObject. The only difference is that the keywords and award_type_codes filters are not required.

Try it

Runs against the live API. Responses are real data.

POST/api/v2/search/spending_by_transaction_count/

Response · 200

  • resultsobjectRequired6 fields
    • idvsnumberRequired

      Example 1

    • loansnumberRequired

      Example 100

    • direct_paymentsnumberRequired

      Example 80

    • contractsnumberRequired

      Example 9

    • othernumberRequired

      Example 0

    • grantsnumberRequired

      Example 0

Example response
{
  "results": {
    "idvs": 597,
    "loans": 1,
    "direct_payments": 0,
    "contracts": 100732,
    "other": 0,
    "grants": 35
  }
}

Recent changes

Generated from contracts/v2/search/spending_by_transaction_count.md in the USAspending API repo.

Loading…