[DEV-6723] Adding DEFC U to the contracts

tony-sappe · tony-sappe · commit 9adb2edda810 · 2021-02-11T15:25:46.000-07:00
diff --git a/usaspending_api/api_contracts/contracts/v2/disaster/agency/count.md b/usaspending_api/api_contracts/contracts/v2/disaster/agency/count.md
@@ -42,10 +42,10 @@ This endpoint returns a count of Agencies
 ## Filter (object)
 + `def_codes` (required, array[DEFC], fixed-type)
 + `award_type_codes` (optional, array[AwardTypeCodes], fixed-type)
-    
-    If this parameter provided, count will be calculated form the distinct set of toptier agencies, whose subtier agencies funded awards linked to FinancialAccountsByAwards records (which are derived from DABS File C) related to the provided DEF codes. 
-    
-    If this parameter is not provided count will be calculated from the distinct set of toptier agencies "owning" appropriations accounts used in funding this disaster (from FinancialAccountsByProgramActivityObjectClass records, which are derived from DABS File B). 
+
+    If this parameter provided, count will be calculated form the distinct set of toptier agencies, whose subtier agencies funded awards linked to FinancialAccountsByAwards records (which are derived from DABS File C) related to the provided DEF codes.
+
+    If this parameter is not provided count will be calculated from the distinct set of toptier agencies "owning" appropriations accounts used in funding this disaster (from FinancialAccountsByProgramActivityObjectClass records, which are derived from DABS File B).
 
 ## DEFC (enum[string])
 List of Disaster Emergency Fund (DEF) Codes (DEFC) defined by legislation at the time of writing.
@@ -73,6 +73,7 @@ and belong to CARES Act DEFC.
 + `R`
 + `S`
 + `T`
++ `U`
 + `9`
 
 ## AwardTypeCodes (enum[string])
diff --git a/usaspending_api/api_contracts/contracts/v2/disaster/agency/loans.md b/usaspending_api/api_contracts/contracts/v2/disaster/agency/loans.md
@@ -25,7 +25,7 @@ Returns loan spending details of Agencies receiving supplemental funding budgeta
 
             {
                 "filter": {
-                    "def_codes": ["L", "M", "N", "O", "P"],
+                    "def_codes": ["L", "M", "N", "O", "P", "U"],
                     "award_type_codes": ["07", "08"]
                 },
                 "pagination": {
@@ -181,4 +181,5 @@ List of Disaster Emergency Fund (DEF) Codes (DEFC) defined by legislation at the
 + `R`
 + `S`
 + `T`
++ `U`
 + `9`
diff --git a/usaspending_api/api_contracts/contracts/v2/disaster/agency/spending.md b/usaspending_api/api_contracts/contracts/v2/disaster/agency/spending.md
@@ -31,7 +31,7 @@ Returns spending details of Agencies receiving supplemental funding budgetary re
 
             {
                 "filter": {
-                    "def_codes": ["L", "M", "N", "O", "P"],
+                    "def_codes": ["L", "M", "N", "O", "P", "U"],
                     "award_type_codes": ["02", "03", "04", "05", "07", "08", "10", "06", "09", "11", "A", "B", "C", "D", "IDV_A", "IDV_B", "IDV_B_A", "IDV_B_B", "IDV_B_C", "IDV_C", "IDV_D", "IDV_E"]
                 },
                 "pagination": {
@@ -182,6 +182,7 @@ List of Disaster Emergency Fund (DEF) Codes (DEFC) defined by legislation at the
 + `R`
 + `S`
 + `T`
++ `U`
 + `9`
 
 ## AwardTypeCodes (enum[string])
diff --git a/usaspending_api/api_contracts/contracts/v2/disaster/award/amount.md b/usaspending_api/api_contracts/contracts/v2/disaster/award/amount.md
@@ -24,7 +24,7 @@ This endpoint provides the Account obligation and outlay aggregations of Awards
 
             {
                 "filter": {
-                    "def_codes": ["L", "M", "N", "O", "P"],
+                    "def_codes": ["L", "M", "N", "O", "P", "U"],
                     "award_type_codes": ["02", "03", "04", "05", "07", "08", "10", "06", "09", "11", "A", "B", "C", "D", "IDV_A", "IDV_B", "IDV_B_A", "IDV_B_B", "IDV_B_C", "IDV_C", "IDV_D", "IDV_E"]
                 },
                 "pagination": {
@@ -95,6 +95,7 @@ and belong to CARES Act DEFC.
 + `R`
 + `S`
 + `T`
++ `U`
 + `9`
 
 ## AwardTypeCodes (enum[string])
diff --git a/usaspending_api/api_contracts/contracts/v2/disaster/award/count.md b/usaspending_api/api_contracts/contracts/v2/disaster/award/count.md
@@ -69,6 +69,7 @@ List of Disaster Emergency Fund (DEF) Codes (DEFC) defined by legislation at the
 + `R`
 + `S`
 + `T`
++ `U`
 + `9`
 
 ## AwardTypeCodes (enum[string])
diff --git a/usaspending_api/api_contracts/contracts/v2/disaster/cfda/count.md b/usaspending_api/api_contracts/contracts/v2/disaster/cfda/count.md
@@ -68,6 +68,7 @@ List of Disaster Emergency Fund (DEF) Codes (DEFC) defined by legislation at the
 + `R`
 + `S`
 + `T`
++ `U`
 + `9`
 
 ## AssistanceAwardTypeCodes (enum[string])
diff --git a/usaspending_api/api_contracts/contracts/v2/disaster/cfda/loans.md b/usaspending_api/api_contracts/contracts/v2/disaster/cfda/loans.md
@@ -25,7 +25,7 @@ Returns loan spending details of CFDA Programs receiving supplemental funding bu
 
             {
                 "filter": {
-                    "def_codes": ["L", "M", "N", "O", "P"],
+                    "def_codes": ["L", "M", "N", "O", "P", "U"],
                     "award_type_codes": ["07", "08"]
                 },
                 "pagination": {
@@ -190,4 +190,5 @@ List of Disaster Emergency Fund (DEF) Codes (DEFC) defined by legislation at the
 + `R`
 + `S`
 + `T`
++ `U`
 + `9`
diff --git a/usaspending_api/api_contracts/contracts/v2/disaster/cfda/spending.md b/usaspending_api/api_contracts/contracts/v2/disaster/cfda/spending.md
@@ -30,7 +30,7 @@ Returns spending details of CFDA receiving supplemental funding budgetary resour
 
             {
                 "filter": {
-                    "def_codes": ["L", "M", "N", "O", "P"],
+                    "def_codes": ["L", "M", "N", "O", "P", "U"],
                     "award_type_codes": ["02", "03", "04", "05", "07", "08", "10", "06", "09", "11"]
                 },
                 "pagination": {
@@ -185,6 +185,7 @@ List of Disaster Emergency Fund (DEF) Codes (DEFC) defined by legislation at the
 + `R`
 + `S`
 + `T`
++ `U`
 + `9`
 
 ## AwardTypeCodes (enum[string])
diff --git a/usaspending_api/api_contracts/contracts/v2/disaster/def_code/count.md b/usaspending_api/api_contracts/contracts/v2/disaster/def_code/count.md
@@ -66,4 +66,5 @@ List of Disaster Emergency Fund (DEF) Codes (DEFC) defined by legislation at the
 + `R`
 + `S`
 + `T`
++ `U`
 + `9`
diff --git a/usaspending_api/api_contracts/contracts/v2/disaster/federal_account/count.md b/usaspending_api/api_contracts/contracts/v2/disaster/federal_account/count.md
@@ -66,4 +66,5 @@ List of Disaster Emergency Fund (DEF) Codes (DEFC) defined by legislation at the
 + `R`
 + `S`
 + `T`
++ `U`
 + `9`
diff --git a/usaspending_api/api_contracts/contracts/v2/disaster/federal_account/loans.md b/usaspending_api/api_contracts/contracts/v2/disaster/federal_account/loans.md
@@ -25,7 +25,7 @@ Returns loan spending details of Federal Accounts receiving supplemental funding
 
             {
                 "filter": {
-                    "def_codes": ["L", "M", "N", "O", "P"]
+                    "def_codes": ["L", "M", "N", "O", "P", "U"]
                 },
                 "pagination": {
                     "limit": 10,
@@ -165,4 +165,5 @@ List of Disaster Emergency Fund (DEF) Codes (DEFC) defined by legislation at the
 + `R`
 + `S`
 + `T`
++ `U`
 + `9`
diff --git a/usaspending_api/api_contracts/contracts/v2/disaster/federal_account/spending.md b/usaspending_api/api_contracts/contracts/v2/disaster/federal_account/spending.md
@@ -31,7 +31,7 @@ Returns spending details of Federal Account and TAS receiving supplemental fundi
             {
                 "filter": {
                     "def_codes": [
-                        "L", "M", "N", "O", "P"
+                        "L", "M", "N", "O", "P", "U"
                     ]
                 },
                 "spending_type": "total",
@@ -188,6 +188,7 @@ List of Disaster Emergency Fund (DEF) Codes (DEFC) defined by legislation at the
 + `R`
 + `S`
 + `T`
++ `U`
 + `9`
 
 ## AwardTypeCodes (enum[string])
diff --git a/usaspending_api/api_contracts/contracts/v2/disaster/object_class/count.md b/usaspending_api/api_contracts/contracts/v2/disaster/object_class/count.md
@@ -66,4 +66,5 @@ List of Disaster Emergency Fund (DEF) Codes (DEFC) defined by legislation at the
 + `R`
 + `S`
 + `T`
++ `U`
 + `9`
diff --git a/usaspending_api/api_contracts/contracts/v2/disaster/object_class/loans.md b/usaspending_api/api_contracts/contracts/v2/disaster/object_class/loans.md
@@ -25,7 +25,7 @@ Returns loan spending details of Object Classes receiving supplemental funding b
 
             {
                 "filter": {
-                    "def_codes": ["L", "M", "N", "O", "P"]
+                    "def_codes": ["L", "M", "N", "O", "P", "U"]
                 },
                 "pagination": {
                     "limit": 10,
@@ -166,4 +166,5 @@ List of Disaster Emergency Fund (DEF) Codes (DEFC) defined by legislation at the
 + `R`
 + `S`
 + `T`
++ `U`
 + `9`
diff --git a/usaspending_api/api_contracts/contracts/v2/disaster/object_class/spending.md b/usaspending_api/api_contracts/contracts/v2/disaster/object_class/spending.md
@@ -30,7 +30,7 @@ Returns spending details of Object Classes receiving supplemental funding budget
 
             {
                 "filter": {
-                    "def_codes": ["L", "M", "N", "O", "P"],
+                    "def_codes": ["L", "M", "N", "O", "P", "U"],
                     "award_type_codes": ["02", "03", "04", "05", "07", "08", "10", "06", "09", "11", "A", "B", "C", "D", "IDV_A", "IDV_B", "IDV_B_A", "IDV_B_B", "IDV_B_C", "IDV_C", "IDV_D", "IDV_E"]
                 },
                 "pagination": {
@@ -176,6 +176,7 @@ List of Disaster Emergency Fund (DEF) Codes (DEFC) defined by legislation at the
 + `R`
 + `S`
 + `T`
++ `U`
 + `9`
 
 ## AwardTypeCodes (enum[string])
diff --git a/usaspending_api/api_contracts/contracts/v2/disaster/overview.md b/usaspending_api/api_contracts/contracts/v2/disaster/overview.md
@@ -9,7 +9,7 @@ This endpoint provides funding and spending details from emergency/disaster supp
 
 + Request (application/json)
     + Parameters
-        + `def_codes` (optional, array[DEFC]) 
+        + `def_codes` (optional, array[DEFC])
            Comma-delimited list of DEF codes to limit results to.
 
 + Response 200 (application/json)
@@ -85,4 +85,5 @@ List of Disaster Emergency Fund (DEF) Codes (DEFC) defined by legislation at the
 + `R`
 + `S`
 + `T`
-+ `9`
++ `U`
++ `9`
diff --git a/usaspending_api/api_contracts/contracts/v2/disaster/recipient/count.md b/usaspending_api/api_contracts/contracts/v2/disaster/recipient/count.md
@@ -24,7 +24,7 @@ This endpoint returns a count of Recipients
 
             {
                 "filter": {
-                    "def_codes": ["L", "M", "N"]
+                    "def_codes": ["L", "M", "N", "O", "P", "U"]
                 }
             }
 
@@ -54,6 +54,7 @@ Will filter on File D records that have at least one File C with the provided DE
 + `N`
 + `O`
 + `P`
++ `U`
 
 ## AwardTypeCodes (enum[string])
 List of procurement and assistance award type codes supported by USAspending.gov
diff --git a/usaspending_api/api_contracts/contracts/v2/disaster/recipient/loans.md b/usaspending_api/api_contracts/contracts/v2/disaster/recipient/loans.md
@@ -25,7 +25,7 @@ Returns loan spending details of recipients receiving supplemental funding budge
 
             {
                 "filter": {
-                    "def_codes": ["L", "M", "N", "O", "P"],
+                    "def_codes": ["L", "M", "N", "O", "P", "U"],
                     "award_type_codes": ["07", "08"]
                 },
                 "pagination": {
@@ -168,4 +168,5 @@ List of Disaster Emergency Fund (DEF) Codes (DEFC) defined by legislation at the
 + `R`
 + `S`
 + `T`
++ `U`
 + `9`
diff --git a/usaspending_api/api_contracts/contracts/v2/disaster/recipient/spending.md b/usaspending_api/api_contracts/contracts/v2/disaster/recipient/spending.md
@@ -25,7 +25,7 @@ Returns spending details of Recipients receiving supplemental funding budgetary
 
             {
                 "filter": {
-                    "def_codes": ["L", "M", "N", "O", "P"],
+                    "def_codes": ["L", "M", "N", "O", "P", "U"],
                     "award_type_codes": ["02", "03", "04", "05", "07", "08", "10", "06", "09", "11", "A", "B", "C", "D", "IDV_A", "IDV_B", "IDV_B_A", "IDV_B_B", "IDV_B_C", "IDV_C", "IDV_D", "IDV_E"]
                 },
                 "pagination": {
@@ -157,6 +157,7 @@ List of Disaster Emergency Fund (DEF) Codes (DEFC) defined by legislation at the
 + `R`
 + `S`
 + `T`
++ `U`
 + `9`
 
 ## AwardTypeCodes (enum[string])
diff --git a/usaspending_api/api_contracts/contracts/v2/disaster/spending_by_geography.md b/usaspending_api/api_contracts/contracts/v2/disaster/spending_by_geography.md
@@ -40,7 +40,7 @@ This endpoint provides geographical spending information from emergency/disaster
 
             {
                 "filter": {
-                    "def_codes": ["L", "M", "N", "O", "P"]
+                    "def_codes": ["L", "M", "N", "O", "P", "U"]
                 },
                 "geo_layer": "state",
                 "geo_layer_filters": ["NE", "WY", "CO", "IA", "IL", "MI", "IN", "TX"],
@@ -141,6 +141,7 @@ List of Disaster Emergency Fund (DEF) Codes (DEFC) defined by legislation at the
 + `R`
 + `S`
 + `T`
++ `U`
 + `9`
 
 ## AwardTypeCodes (enum[string])
diff --git a/usaspending_api/api_contracts/contracts/v2/download/disaster.md b/usaspending_api/api_contracts/contracts/v2/download/disaster.md
@@ -17,7 +17,7 @@ Creates a new download job for the requested account and award. Returns a link t
 
             {
                 "filters": {
-                    "def_codes": ["L", "M", "N", "O", "P"]
+                    "def_codes": ["L", "M", "N", "O", "P", "U"]
                 }
             }
 
@@ -82,4 +82,5 @@ List of Disaster Emergency Fund (DEF) Codes (DEFC) defined by legislation at the
 + `R`
 + `S`
 + `T`
-+ `9`
++ `U`
++ `9`
diff --git a/usaspending_api/api_contracts/contracts/v2/download/disaster/recipients.md b/usaspending_api/api_contracts/contracts/v2/download/disaster/recipients.md
@@ -15,7 +15,7 @@ Creates a new download job for the requested filters. Returns a link to a zipped
 
             {
                 "filters": {
-                    "def_codes": ["L", "M", "N", "O", "P"],
+                    "def_codes": ["L", "M", "N", "O", "P", "U"],
                     "award_type_codes": ["A", "B", "C", "D"]
                 }
             }
@@ -98,6 +98,7 @@ List of Disaster Emergency Fund (DEF) Codes (DEFC) defined by legislation at the
 + `R`
 + `S`
 + `T`
++ `U`
 + `9`
 
 ## AwardTypeCodes (enum[string])
diff --git a/usaspending_api/api_contracts/contracts/v2/references/def_codes.md b/usaspending_api/api_contracts/contracts/v2/references/def_codes.md
diff --git a/usaspending_api/api_contracts/contracts/v2/search/spending_by_award.md b/usaspending_api/api_contracts/contracts/v2/search/spending_by_award.md

-Original file line number
+Diff line change
 + `R`
 + `S`
 + `T`
 ++ `U`
 + `9`
 ## AwardTypeCodes (enum[string])