USAspending API ReferenceIndependent
Try the API

Recipient Duns

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

Deprecated: Please see the following API contract instead: usaspending_api/api_contracts/contracts/v2/recipient.md

These endpoints are used to power USAspending.gov's recipient profile pages. This data can be used to visualize the government spending that pertains to a specific recipient.

This endpoint returns a list of recipients, their level, DUNS, and amount.

Request

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"
}'

Request body

  • orderenum (string)

    The direction results are sorted by. asc for ascending, desc for descending.

    Allowed values
    • asc
    • desc

    Default desc

  • sortenum (string)

    The field results are sorted by.

    Allowed values
    • name
    • duns
    • amount

    Default amount

  • limitnumber

    The number of results to include per page. Maximum: 1000

    Default 50

  • pagenumber

    The page of results to return based on the limit.

    Default 1

  • keywordstring

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

  • award_typeenum (string)

    The award type results are filtered by.

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

    Default all

Try it

Runs against the live API. Responses are real data.

POST/api/v2/recipient/duns/

Response · 200

  • page_metadataobject · PageMetaDataObject3 fields
    • pagenumberRequired

      The page number.

    • limitnumberRequired

      The number of results per page.

    • totalnumberRequired

      The total number of results (all pages).

  • resultsarray of RecipientListing6 fields
    • namestringRequiredNullable

      Name of the recipient. null when the name is not provided.

    • dunsstringRequiredNullable

      Recipient's DUNS (Data Universal Numbering System) number. null when no DUNS is provided.

    • ueistringRequiredNullable

      Recipient's UEI (Unique Entity Identifier). null when no UEI is provided.

    • idstringRequired

      A unique identifier for the recipient at this recipient_level.

    • amountnumberRequired

      The aggregate monetary value of all transactions associated with this recipient for the trailing 12 months.

    • recipient_levelenum (string)Required

      A letter representing the recipient level. R for neither parent nor child, P for Parent Recipient, or C for child recipient.

      Allowed values
      • R
      • P
      • C
Example response
{
  "page_metadata": {
    "page": 1,
    "total": 6426446,
    "limit": 50,
    "next": 2,
    "previous": null,
    "hasNext": true,
    "hasPrevious": false
  },
  "results": [
    {
      "id": "1c3edaaa-611b-840c-bf2b-fd34df49f21f-P",
      "duns": "071549000",
      "uei": "NUDGYLBB4S99",
      "name": "CALIFORNIA, STATE OF",
      "recipient_level": "P",
      "amount": 125645635660.93
    },
    {
      "id": "9f972e57-c05f-b374-bf11-0408f30da215-R",
      "duns": null,
      "uei": null,
      "name": "OPTUM BANK",
      "recipient_level": "R",
      "amount": 99578072991.9
    },
    {
      "id": "b0e81504-fe4b-96fb-ae3c-27b1a7fb4cda-P",
      "duns": "041002973",
      "uei": "DKBAJQ45GQS8",
      "name": "NEW YORK, STATE OF",
      "recipient_level": "P",
      "amount": 81273339054.44
    },
    {
      "id": "bf782d74-80d4-581e-ae9f-3b5b57092d7d-C",
      "duns": "796528263",
      "uei": "JE73CDQUAPA7",
      "name": "HEALTH CARE SERVICES, CALIFORNIA DEPARTMENT OF",
      "recipient_level": "C",
      "amount": 66803275488
    }
  ]
}

Recent changes

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

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

Loading…