USAspending API ReferenceIndependent
Try the API

Specific Recipient Duns

GET/api/v2/recipient/duns/{recipient_id}/
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/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 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/duns/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/duns/45700e3c-05bc-6426-ddc6-5e0ce1664716-C/

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

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

Loading…