USAspending API ReferenceIndependent
Try the API

IDV Award Amounts

GET/api/v2/idvs/amounts/{award_id}/
Powers Award summaries on usaspending.gov How an award summary is built

Used to populate the Federal Account Funding tab on the IDV summary page.

Get aggregated award counts and funding amounts for IDV contracts

Request

curl 'https://api.usaspending.gov/api/v2/idvs/amounts/CONT_IDV_FA304715A0037_9700/'

Path parameters

  • award_idstringRequired

    Either a "generated" natural award id (string) or a database surrogate award id (number). Generated award identifiers are preferred as they are effectively permanent. Surrogate award ids are retained for backward compatibility but are deprecated.

    Example CONT_IDV_FA304715A0037_9700

Try it

Runs against the live API. Responses are real data.

GET/api/v2/idvs/amounts/CONT_IDV_FA304715A0037_9700/

Response · 200

  • award_idnumberRequired

    Example 68841198

  • generated_unique_award_idstringRequired

    Example CONT_IDV_GS10F0201R_4730

  • child_idv_countnumberRequired

    Example 2

  • child_award_countnumberRequired

    Example 25

  • child_award_total_obligationnumberRequired

    Example 363410.59

  • child_award_base_and_all_options_valuenumberRequired

    Example 297285.59

  • child_award_base_exercised_options_valnumberRequired

    Example 297285.59

  • child_total_account_outlaynumberRequired

    Example 0

  • child_total_account_obligationnumberRequired

    Example 0

  • child_award_total_outlaynumberRequiredNullable

    Example 0

  • child_account_outlays_by_defcarray of stringRequired

    Example [""]

  • child_account_obligations_by_defcarray of stringRequired

    Example [""]

  • grandchild_award_countnumberRequired

    Example 54

  • grandchild_award_total_obligationnumberRequired

    Example 377145.57

  • grandchild_award_base_and_all_options_valuenumberRequired

    Example 306964.49

  • grandchild_award_base_exercised_options_valnumberRequired

    Example 311020.57

  • grandchild_total_account_outlaynumberRequired

    Example 0

  • grandchild_total_account_obligationnumberRequired

    Example 0

  • grandchild_award_total_outlaynumberRequiredNullable

    Example 0

  • grandchild_account_outlays_by_defcarray of stringRequired

    Example [""]

  • grandchild_account_obligations_by_defcarray of stringRequired

    Example [""]

Example response
{
  "award_id": 68841198,
  "generated_unique_award_id": "CONT_IDV_GS10F0201R_4730",
  "child_idv_count": 2,
  "child_award_count": 25,
  "child_award_total_obligation": 363410.59,
  "child_award_base_and_all_options_value": 297285.59,
  "child_award_base_exercised_options_val": 297285.59,
  "grandchild_award_count": 54,
  "grandchild_award_total_obligation": 377145.57,
  "grandchild_award_base_and_all_options_value": 306964.49,
  "grandchild_award_base_exercised_options_val": 311020.57
}

Recent changes

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

Generated from contracts/v2/idvs/amounts/award_id.md in the USAspending API repo.

Loading…