USAspending API ReferenceIndependent
Try the API

Recipient profiles

Award totals and details for each recipient, parent, and child.

POST3GET3Open on usaspending.gov How a recipient profile is built

Open a row for parameters and ready-to-run samples. The full reference has every field and a live console.

POSTRecipient/api/v2/recipient/

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

ordersortlimitpagekeywordaward_type
curl -X POST 'https://api.usaspending.gov/api/v2/recipient/' \
  -H 'Content-Type: application/json' \
  -d '{
  "order": "desc",
  "sort": "amount",
  "page": 1,
  "limit": 50,
  "award_type": "all"
}'
Full reference and live console Contract
GETSpecific Recipient Duns/api/v2/recipient/{recipient_id}/

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

{recipient_id} *?year
curl 'https://api.usaspending.gov/api/v2/recipient/45700e3c-05bc-6426-ddc6-5e0ce1664716-C/'
Full reference and live console Contract
GETRecipient Children/api/v2/recipient/children/{duns_or_uei}/

This endpoint is used to power USAspending.gov's recipient profile pages.

{duns_or_uei} *?year
curl 'https://api.usaspending.gov/api/v2/recipient/children/001006360/'
Full reference and live console Contract
POSTRecipient Duns/api/v2/recipient/count/

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

keywordaward_typeBody
curl -X POST 'https://api.usaspending.gov/api/v2/recipient/count/' \
  -H 'Content-Type: application/json' \
  -d '{
  "award_type": "all",
  "Body": ""
}'
Full reference and live console Contract
POSTRecipient Duns/api/v2/recipient/duns/

Deprecated: Please see the following API contract instead: usaspendingapi/apicontracts/contracts/v2/recipient.md These endpoints are used to power USAspending.gov's recipient profile pages.

ordersortlimitpagekeywordaward_type
curl -X POST 'https://api.usaspending.gov/api/v2/recipient/duns/' \
  -H 'Content-Type: application/json' \
  -d '{
  "order": "desc",
  "sort": "amount",
  "page": 1,
  "limit": 50,
  "award_type": "all"
}'
Full reference and live console Contract
GETSpecific Recipient Duns/api/v2/recipient/duns/{recipient_id}/

Deprecated: Please see the following API contract instead: usaspendingapi/apicontracts/contracts/v2/recipient/recipient.md These endpoints are used to power USAspending.gov's recipient profile pages.

{recipient_id} *?year
curl 'https://api.usaspending.gov/api/v2/recipient/duns/45700e3c-05bc-6426-ddc6-5e0ce1664716-C/'
Full reference and live console Contract

Loading…