USAspending API ReferenceIndependent
Try the API

Recipient Duns

POST/api/v2/recipient/count/
Powers Recipient profiles on usaspending.gov How a recipient profile is built

These endpoints are used to power USAspending.gov's recipient profile pages.

This endpoint returns the count of recipients given an award_type and keyword string.

Request

curl -X POST 'https://api.usaspending.gov/api/v2/recipient/count/' \
  -H 'Content-Type: application/json' \
  -d '{
  "award_type": "all",
  "Body": ""
}'

Request body

  • keywordstring

    The keyword results are filtered by. Searches on name, UEI, and DUNS.

  • award_typeenum (string)

    The award type results are filtered by.

    Allowed values
    • all
    • contracts
    • grants
    • loans
    • direct_payments
    • other_financial_assistance

    Default all

  • Bodystring

    { "award_type": "all" }

Try it

Runs against the live API. Responses are real data.

POST/api/v2/recipient/count/

Response · 200

  • countnumberRequired
Example response
{
  "count": 10966055
}

Recent changes

No contract changes to this endpoint since October 2024. The changelog covers every endpoint.

Generated from contracts/v2/recipient/count.md in the USAspending API repo.

Loading…