USAspending API ReferenceIndependent
Try the API

Recipient List

GET/api/v2/award_spending/recipient/
usaspending.gov doesn't call this endpoint directly.

This endpoint lists all all award spending for a given fiscal year and agency id

This endpoint returns a list of recipients and their amounts.

Request

curl 'https://api.usaspending.gov/api/v2/award_spending/recipient/'

Try it

Runs against the live API. Responses are real data.

GET/api/v2/award_spending/recipient/

Response · 200

  • page_metadataobject · PageMetadataObject7 fields
    • countnumberRequired

      Example 100

    • pagenumberRequired

      Example 1

    • has_next_pagebooleanRequired

      Example true

    • has_previous_pagebooleanRequired

      Example false

    • nextstringRequiredNullable
    • currentstringRequiredNullable
    • previousstringRequiredNullable
  • resultsarray of RecipientListing3 fields
    • award_categorystringRequiredNullable

      Example contracts

    • obligated_amountstringRequired

      Example 1000000.01

    • recipientobject · RecipientObject1 field
      • recipient_namestringRequired

        Example Company Inc.

Example response
{
  "page_metadata": {
    "count": 100,
    "page": 1,
    "has_next_page": true,
    "has_previous_page": false,
    "next": null,
    "current": null,
    "previous": null
  },
  "results": [
    {
      "award_category": "contracts",
      "obligated_amount": "1000000.01",
      "recipient": {
        "recipient_name": "Company Inc."
      }
    }
  ]
}

Recent changes

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

Loading…