Specific Recipient Duns

GET/api/v2/recipient/{recipient_id}/

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 data can be used to visualize the government spending that pertains to a specific recipient.

This endpoint returns a high-level overview of a specific recipient, given its id.

Schema

text

      {
          "$schema": "http://json-schema.org/draft-04/schema#",
          "type": "object"
      }

Request

curl 'https://api.usaspending.gov/api/v2/recipient/45700e3c-05bc-6426-ddc6-5e0ce1664716-C/'

Path parameters

recipient_idstringRequired
A unique identifier for the recipient at a specific level (parent, child, or neither).
Example 45700e3c-05bc-6426-ddc6-5e0ce1664716-C

Query parameters

yearstring
The fiscal year you would like data for. Use all to view all time or latest to view the latest 12 months.

Try it

Runs against the live API. Responses are real data.

GET/api/v2/recipient/45700e3c-05bc-6426-ddc6-5e0ce1664716-C/

recipient_id path, required

year query

Response · 200

namestringRequiredNullable
Name of the recipient. null when the name is not provided.
alternate_namesarray of stringRequired
Additional names that the recipient has been / is known by.
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.
recipient_idstringRequired
A unique identifier for the recipient.
parentsarray of ParentRecipientRequired4 fields
- parent_namestringRequiredNullable
- parent_dunsstringRequiredNullable
  DUNS number
- parent_idstringRequiredNullable
  A unique identifier for the parent recipient.
- parent_ueistringRequiredNullable
  Parent recipient's UEI (Unique Entity Identifier). null when no UEI is provided.
parent_namestringRequiredNullable
Parent recipient's name. null if the recipient does not have a parent recipient.
parent_dunsstringRequiredNullable
Parent recipient's DUNS number. null if the recipient does not have a parent recipient, or the parent recipient's DUNS is not provided.
parent_idstringRequiredNullable
A unique identifier for the parent recipient. null if the recipient does not have a parent recipient.
parent_ueistringRequiredNullable
Parent recipient's UEI (Unique Entity Identifier). null when no UEI is provided.
locationobject · RecipientLocationRequired13 fields
- address_line1stringRequiredNullable
  The first line of the recipient's street address.
- address_line2stringRequiredNullable
  Second line of the recipient's street address.
- address_line3stringRequiredNullable
  Third line of the recipient's street address.
- foreign_provincestringRequiredNullable
  Name of the province in which the recipient is located, if it is outside the United States.
- city_namestringRequiredNullable
  Name of the city in which the recipient is located.
- county_namestringRequiredNullable
  Name of the county in which the recipient is located.
- state_codestringRequiredNullable
  Code for the state in which the recipient is located.
- zipstringRequiredNullable
  Recipient's zip code (5 digits)
- zip4stringRequiredNullable
  Recipient's zip code (4 digits)
- foreign_postal_codestringRequiredNullable
  Recipient's postal code, if it is outside the United States.
- country_namestringRequiredNullable
  Name of the country in which the recipient is located.
- country_codestringRequiredNullable
  Code for the country in which the recipient is located.
- congressional_codestringRequiredNullable
  Number for the recipient's congressional district.
business_typesarray of stringRequired
An array of business type field names used to categorize recipients.
total_transaction_amountnumberRequired
The aggregate monetary value of all transactions associated with this recipient for the given time period.
total_transactionsnumberRequired
The number of transactions associated with this recipient for the given time period.
total_face_value_loan_amountnumberRequired
The aggregate face value loan guarantee value of all transactions associated with this recipient for the given time period.
total_face_value_loan_transactionsnumberRequired
The number of transactions associated with this recipient for the given time period and face value loan guarantee.
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

{
  "name": "ART LINE WHOLESALERS, INC.",
  "alternate_names": [
    "ARTLINE WHOLESALERS INC"
  ],
  "duns": "058675323",
  "uei": "NUDGYLBB4S99",
  "recipient_id": "1c0c11fa-ee74-ced4-75c3-0b5a0d4826db-P",
  "recipient_level": "P",
  "parent_id": "1c0c11fa-ee74-ced4-75c3-0b5a0d4826db-P",
  "parent_name": "ART LINE WHOLESALERS, INC.",
  "parent_duns": "058675323",
  "parent_uei": "D1RMTDTMKLE8",
  "parents": [
    {
      "parent_id": "1c0c11fa-ee74-ced4-75c3-0b5a0d4826db-P",
      "parent_duns": "058675323",
      "parent_uei": "D1RMTDTMKLE8",
      "parent_name": "ART LINE WHOLESALERS, INC."
    }
  ],
  "business_types": [
    "category_business",
    "corporate_entity_not_tax_exempt",
    "minority_owned_business",
    "self_certified_small_disadvanted_business",
    "small_business",
    "special_designations",
    "subcontinent_asian_indian_american_owned_business"
  ],
  "location": {
    "address_line1": "1 MIDLAND AVE",
    "address_line2": null,
    "address_line3": null,
    "foreign_province": null,
    "city_name": "HICKSVILLE",
    "county_name": null,
    "state_code": "NY",
    "zip": "11801",
    "zip4": "4320",
    "foreign_postal_code": null,
    "country_name": "UNITED STATES",
    "country_code": "USA",
    "congressional_code": "03"
  },
  "total_transaction_amount": 0,
  "total_transactions": 0,
  "total_face_value_loan_amount": 0,
  "total_face_value_loan_transactions": 0
}

Recent changes

April 21, 2021Mentioned in the April 21, 2021 release notes
April 5, 2021Mentioned in the April 5, 2021 release notes
August 22, 2018Mentioned in the August 22, 2018 release notes

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