USAspending API ReferenceIndependent
Try the API

Recipient Children

GET/api/v2/recipient/children/{duns_or_uei}/
Powers Recipient profiles on usaspending.gov How a recipient profile is built

This endpoint is 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 child recipients belonging to the given parent recipient DUNS or UEI.

Request

curl 'https://api.usaspending.gov/api/v2/recipient/children/001006360/'

Path parameters

  • duns_or_ueistringRequired

    Parent recipient's DUNS or UEI.

    Example 001006360

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.

    Example 2017

Try it

Runs against the live API. Responses are real data.

GET/api/v2/recipient/children/001006360/?year=2017

Response · 200

  • namestringRequiredNullable

    Name of the child recipient. null if the child recipient's name is not provided.

    Example Child of ABC Corporation

  • dunsstringRequiredNullable

    Child recipient's DUNS. null if the child recipient's DUNS is not provided.

    Example 001006360

  • ueistringRequiredNullable

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

  • recipient_idstringRequired

    A unique identifier for the child recipient.

    Example 0036a0cb-0d88-2db3-59e0-0f9af8ffef57-C

  • state_provincestringRequiredNullable

    The state or province in which the child recipient is located.

    Example New Jersey

  • amountnumberRequired

    The aggregate monetary value of transactions associated with this child recipient for the selected time period.

    Example 300200000

Example response
[
  {
    "name": "Child of ABC Corporation",
    "duns": "001006360",
    "uei": null,
    "recipient_id": "0036a0cb-0d88-2db3-59e0-0f9af8ffef57-C",
    "state_province": "New Jersey",
    "amount": 300200000
  }
]

Recent changes

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

Loading…