USAspending API ReferenceIndependent
Try the API

CFDA Programs Spending Disaster/Emergency Funding via Loans

POST/api/v2/disaster/cfda/loans/
Powers COVID-19 spending on usaspending.gov

This endpoint provides insights on the CFDA Programs' loans from disaster/emergency funding per the requested filters.

Returns loan spending details of CFDA Programs receiving supplemental funding budgetary resources

Request

curl -X POST 'https://api.usaspending.gov/api/v2/disaster/cfda/loans/' \
  -H 'Content-Type: application/json' \
  -d '{
  "filter": {
    "def_codes": [
      "L",
      "M",
      "N",
      "O",
      "P",
      "U"
    ],
    "award_type_codes": [
      "07",
      "08"
    ]
  },
  "pagination": {
    "limit": 10,
    "page": 1,
    "sort": "award_count",
    "order": "desc"
  },
  "spending_type": "total"
}'

Request body

  • filterobject · FilterRequired3 fields
    • def_codesarray of DEFCRequired

      List of Disaster Emergency Fund (DEF) Codes (DEFC) defined by legislation at the time of writing. When filtering on award_type_codes this will filter on File D records that have at least one File C with the provided DEFC and belong to CARES Act DEFC. A list of current DEFC can be found here.

    • award_type_codesarray of string

      Only accepts loan award type 07 or 08 in the array, since this endpoint is specific to loans

      Default ["07", "08"]

      Example ["07","08"]

    • querystring

      A "keyword" or "search term" to filter down results based on this text snippet

  • paginationobject · Pagination4 fields
    • pagenumber

      Requested page of results

      Default 1

    • limitnumber

      Page Size of results

      Default 10

    • orderenum (string)

      Indicates what direction results should be sorted by. Valid options include asc for ascending order or desc for descending order.

      Allowed values
      • desc
      • asc

      Default desc

    • sortenum (string)

      Optional parameter indicating what value results should be sorted by

      Allowed values
      • id
      • code
      • description
      • award_count
      • face_value_of_loan
      • obligation
      • outlay

      Default id

Try it

Runs against the live API. Responses are real data.

POST/api/v2/disaster/cfda/loans/

Response · 200

  • totalsobject · TotalsRequired4 fields
    • award_countnumberRequired
    • face_value_of_loannumberRequired
    • obligationnumberRequired
    • outlaynumberRequired
  • resultsarray of ResultRequired13 fields
    • idstringRequired
    • codestringRequired
    • descriptionstringRequired
    • award_countnumberRequired
    • face_value_of_loannumberRequiredNullable
    • obligationnumberRequiredNullable
    • outlaynumberRequiredNullable
    • resource_linkstringRequiredNullable

      Link to an external website with more information about this result.

    • cfda_federal_agencystringRequired
    • cfda_objectivesstringRequired
    • cfda_websitestringRequiredNullable

      Link to an external website with more information about this program.

    • applicant_eligibilitystringRequired
    • beneficiary_eligibilitystringRequired
  • page_metadataobject · PageMetadataRequired7 fields
    • pagenumberRequired
    • nextnumberRequiredNullable
    • previousnumberRequiredNullable
    • hasNextbooleanRequired
    • hasPreviousbooleanRequired
    • totalnumberRequired
    • limitnumberRequired
Example response
{
  "totals": {
    "award_count": 4574,
    "face_value_of_loan": 325642345,
    "obligation": 364037369840.58,
    "outlay": 290416885040.71
  },
  "results": [
    {
      "code": "20.200",
      "award_count": 2,
      "description": "CFDA 2",
      "face_value_of_loan": 330,
      "id": 200,
      "obligation": 220,
      "outlay": 100,
      "resource_link": "www.example.com/200",
      "cfda_federal_agency": "OFFICE OF FEDERAL STUDENT AID, EDUCATION, DEPARTMENT OF",
      "cfda_objectives": "To provide loan capital directly from the Federal government",
      "cfda_website": "http://www.ifap.ed.gov/.",
      "applicant_eligibility": "The applicant must be a U.S. citizen, national, or",
      "beneficiary_eligibility": "Vocational, undergraduate, and graduate"
    },
    {
      "code": "10.100",
      "award_count": 1,
      "description": "CFDA 1",
      "face_value_of_loan": 3,
      "id": 100,
      "obligation": 2,
      "outlay": 0,
      "resource_link": null,
      "cfda_federal_agency": "OFFICE OF FEDERAL STUDENT AID, EDUCATION, DEPARTMENT OF",
      "cfda_objectives": "To provide loan capital directly from the Federal government",
      "cfda_website": "http://www.ifap.ed.gov/.",
      "applicant_eligibility": "The applicant must be a U.S. citizen, national, or",
      "beneficiary_eligibility": "Vocational, undergraduate, and graduate"
    }
  ],
  "page_metadata": {
    "page": 1,
    "next": 2,
    "previous": null,
    "hasNext": true,
    "hasPrevious": false,
    "total": 23,
    "limit": 2
  }
}

Recent changes

Generated from contracts/v2/disaster/cfda/loans.md in the USAspending API repo.

Loading…