Award Funding

Request

curl -X POST 'https://api.usaspending.gov/api/v2/awards/funding/' \
  -H 'Content-Type: application/json' \
  -d '{
  "award_id": "CONT_AWD_0002_2800_SS001740003_2800",
  "limit": 5,
  "page": 1,
  "sort": "reporting_fiscal_date",
  "order": "desc",
  "Body": ""
}'

Request body

• 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_AWD_0002_2800_SS001740003_2800

• limitnumber

  The number of results to include per page.

  Default 10

  Example 5

• pagenumber

  The page of results to return based on limit.

  Default 1

  Example 1

• sortenum (string)

  The field on which to order results.

  Allowed values

  • account_title
  • awarding_agency_name
  • disaster_emergency_fund_code
  • federal_account
  • funding_agency_name
  • gross_outlay_amount
  • object_class Object class code, object class name
  • program_activity Program activity code, program activity name
  • reporting_fiscal_date Reporting fiscal year, reporting fiscal month
  • transaction_obligated_amount

  Default reporting_fiscal_date

• orderenum (string)

  The direction in which to order results. asc for ascending or desc for descending.

  Allowed values

  • asc
  • desc

  Default desc

• Bodystring

  { "award_id":"CONT_AWD_N0001902C3002_9700_-NONE-_-NONE-", "page":1, "sort":"reporting_fiscal_date", "order":"asc", "limit":15 }

Response · 200

• resultsarray of AwardFundingResponseRequired21 fields

  • reporting_fiscal_yearnumberRequiredNullable

    Fiscal year of the submission date.

  • reporting_fiscal_quarternumberRequiredNullable

    Fiscal quarter of the submission date.

  • reporting_fiscal_monthnumberRequiredNullable

    Fiscal month of the submission date.

  • is_quarterly_submissionbooleanRequiredNullable

    True if the submission is quarterly. False if the submission is monthly.

  • disaster_emergency_fund_codebooleanRequiredNullable

    Code indicating whether or not the funding record is associated with a disaster.

  • awarding_agency_idnumberRequiredNullable

    Internal surrogate identifier of the awarding agency.

  • awarding_toptier_agency_idnumberRequiredNullable
  • awarding_agency_slugstringRequiredNullable
  • awarding_agency_namestringRequiredNullable
  • funding_agency_idnumberRequiredNullable

    Internal surrogate identifier of the funding agency.

  • funding_toptier_agency_idnumberRequiredNullable
  • funding_agency_slugstringRequiredNullable
  • funding_agency_namestringRequiredNullable
  • federal_accountstringRequiredNullable

    Identifier of the federal account

  • account_titlestringRequiredNullable

    Federal Account Title

  • program_activity_codestringRequiredNullable
  • program_activity_namestringRequiredNullable
  • object_classstringRequiredNullable
  • object_class_namestringRequiredNullable
  • transaction_obligated_amountnumberRequiredNullable
  • gross_outlay_amountnumberRequiredNullable
• page_metadataobject · PageMetaDataObjectRequired5 fields

  • pagenumberRequired
  • hasNextbooleanRequired
  • hasPreviousbooleanRequired
  • nextnumberRequiredNullable
  • previousnumberRequiredNullable

{
  "results": [
    {
      "transaction_obligated_amount": 70296,
      "gross_outlay_amount": 0,
      "disaster_emergency_fund_code": null,
      "federal_account": "028-8704",
      "account_title": "Salaries and Expenses, Social Security Administration",
      "funding_agency_name": "Social Security Administration",
      "funding_agency_id": 539,
      "funding_toptier_agency_id": 123,
      "funding_agency_slug": "social-security-administration",
      "awarding_agency_name": "Social Security Administration",
      "awarding_agency_id": 539,
      "awarding_toptier_agency_id": 123,
      "awarding_agency_slug": "social-security-administration",
      "object_class": "254",
      "object_class_name": "Operation and maintenance of facilities",
      "program_activity_code": "0001",
      "program_activity_name": "LAE PROGRAM DIRECT",
      "reporting_fiscal_year": 2017,
      "reporting_fiscal_quarter": 4,
      "reporting_fiscal_month": 12,
      "is_quarterly_submission": true
    },
    {
      "transaction_obligated_amount": 6960,
      "gross_outlay_amount": 0,
      "disaster_emergency_fund_code": null,
      "federal_account": "028-0400",
      "account_title": "Office of the Inspector General, Social Security Administration",
      "funding_agency_name": "Social Security Administration",
      "funding_agency_id": 539,
      "funding_toptier_agency_id": 123,
      "funding_agency_slug": "social-security-administration",
      "awarding_agency_name": "Social Security Administration",
      "awarding_agency_id": 539,
      "awarding_toptier_agency_id": 123,
      "awarding_agency_slug": "social-security-administration",
      "object_class": "254",
      "object_class_name": "Operation and maintenance of facilities",
      "program_activity_code": "0001",
      "program_activity_name": "OFFICE OF INSPECTOR GENERAL (DIRECT)",
      "reporting_fiscal_year": 2017,
      "reporting_fiscal_quarter": 4,
      "reporting_fiscal_month": 12,
      "is_quarterly_submission": true
    }
  ],
  "page_metadata": {
    "page": 1,
    "next": null,
    "previous": null,
    "hasNext": false,
    "hasPrevious": false
  }
}

Recent changes

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

Generated from contracts/v2/awards/funding.md in the USAspending API repo.