Technical guide with examples
Scope 1 project with custom baseline method
Definitions
- Project: a collection of fields
- Field: a physical field used for farming, in which management practices take place
Steps
- The user creates a project
- The user submits one or more fields to the project
- The user can delete fields while the project is not finalized
- The user finalizes the project, which means all the fields were submitted and the quantification calculations can begin
- The user retrieves the final project outputs
The intervention module has a decent amount of business logic and it is strong encouraged to read the product documentation in the knowledge base (https://help.regrow.ag/measure-api#intervention-module).
Create a project
We create the project making a POST request to endpoint /api/projects:
curl -X 'POST' \
'https://api.regrow.ag/dndc-scenarios-service/v0/api/projects?project_name=my_project&protocol=sep&baseline_method=custom' \
-H 'accept: application/json' \
-H 'x-apikey: <api_key>' \
-d ''
And get a success response:
{"message": "Created project my_project"}
Submit fields
A project can have any number of fields, but it’s best practice group fields with some commonality into projects. For example, fields can be grouped into projects based on a region (such as a country or climate region), a crop type (such that all fields growing the same crop are in a single project), or a reporting time period (such as a crop year).
A field (also referred to as a session input) is a collection of field data (such as field boundaries), field conditions (such as soil data) and farm management events (such as crop, tillage, irrigation and nutrient management data).
We submit field information by making a POST request to endpoint /api/projects/{project_name}/fields. They must be uniquely named inside the project.
In this example we are going to submit two fields. The first one is called Field 1; it contains several events between 2019 and 2024, and the interventions that were applied are no tillage events and oat as a cover crop. This can be observed during the reporting period, that is between August 17th 2023 and September 18th 2024. The reporting crop is corn.
The request to submit the field is the following:
curl -X 'POST' \
'https://api.regrow.ag/dndc-scenarios-service/v0/api/projects/my_project/fields' \
-H 'accept: application/json' \
-H 'x-apikey: <api_key>' \
-H 'Content-Type: application/json' \
-d '{
"session_name": "Field 1",
"scenarios": [
{
"name": "baseline",
"location": {
"latlon": {
"latitude": 44.5678850871186,
"longitude": -93.6434846029078
},
"area": 71.098,
"area_unit": "acre"
},
"rotations": [
{
"phases": [
{
"start_date": "2019-04-24",
"end_date": "2024-09-18",
"management_events": {
"irrigation": [
{
"date": "2019-06-03",
"water_amount": 19.96691324,
"method": "sprinkler",
"depth": 0
},
{
"date": "2020-05-26",
"water_amount": 19.96691324,
"method": "sprinkler",
"depth": 0
},
{
"date": "2021-06-01",
"water_amount": 19.96691324,
"method": "sprinkler",
"depth": 0
},
{
"date": "2022-05-25",
"water_amount": 19.96691324,
"method": "sprinkler",
"depth": 0
},
{
"date": "2023-04-28",
"water_amount": 19.96691324,
"method": "sprinkler",
"depth": 0
},
{
"date": "2024-05-25",
"water_amount": 19.96691324,
"method": "sprinkler",
"depth": 0
}
],
"till": [
{
"date": "2019-04-24",
"soil_inverted": false,
"depth": 19.05,
"strip_frac": 0.333333333333333
},
{
"date": "2019-10-22",
"soil_inverted": false,
"depth": 17.78
},
{
"date": "2020-04-26",
"soil_inverted": false,
"depth": 6.35
},
{
"date": "2021-05-05",
"soil_inverted": false,
"depth": 17.78
},
{
"date": "2022-10-05",
"soil_inverted": false,
"depth": 6.35
},
{
"date": "2023-11-11",
"soil_inverted": false,
"depth": 17.78
},
{
"date": "2024-05-17",
"soil_inverted": false,
"depth": 6.35
}
],
"cropping": [
{
"start_date": "2019-05-13",
"end_date": "2019-09-18",
"name": "corn",
"reductions": [
{
"date": "2019-09-18",
"type": "grain_harvest"
}
]
},
{
"start_date": "2020-04-27",
"end_date": "2020-10-15",
"name": "corn",
"reductions": [
{
"date": "2020-10-15",
"type": "grain_harvest"
}
]
},
{
"start_date": "2021-05-26",
"end_date": "2021-09-22",
"name": "dry_bean",
"reductions": [
{
"date": "2021-09-22",
"type": "grain_harvest"
}
]
},
{
"start_date": "2021-09-15",
"end_date": "2022-05-04",
"name": "oat"
},
{
"start_date": "2022-05-18",
"end_date": "2022-09-07",
"name": "corn",
"reductions": [
{
"date": "2022-09-07",
"type": "grain_harvest"
}
]
},
{
"start_date": "2022-09-15",
"end_date": "2023-08-08",
"name": "rye",
"reductions": [
{
"date": "2023-08-08",
"custom": {
"frac_grain_removed": 1,
"frac_grain_residue": 0,
"frac_leaf_removed": 0.8,
"frac_leaf_residue": 0,
"frac_stem_residue": 0,
"frac_stem_removed": 0.8,
"frac_root_removed": 0,
"frac_root_residue": 0
}
}
]
},
{
"start_date": "2023-08-16",
"end_date": "2023-08-16",
"name": "oat"
},
{
"start_date": "2024-05-18",
"end_date": "2024-09-07",
"name": "corn",
"reductions": [
{
"date": "2024-09-07",
"type": "grain_harvest"
}
]
}
],
"application": [
{
"date": "2019-05-13",
"name": "urea_ammonium_nitrate_28",
"amount": 4,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 5.08,
"liq_dry": "liquid",
"application_method": "subsurface",
"area_unit": "acre",
"rate_unit": "gallon"
},
{
"date": "2019-06-08",
"name": "ammonium_sulfate",
"amount": 100,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2019-06-26",
"name": "ammonia_anhydrous",
"amount": 34.95,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 15.24,
"liq_dry": "liquid",
"application_method": "inject",
"additives": [
"n_serve"
],
"area_unit": "acre",
"rate_unit": "gallon"
},
{
"date": "2020-04-27",
"name": "urea_ammonium_nitrate_28",
"amount": 4,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "liquid",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "gallon"
},
{
"date": "2020-06-01",
"name": "ammonium_sulfate",
"amount": 100,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2020-06-16",
"name": "ammonia_anhydrous",
"amount": 46.6,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 15.24,
"liq_dry": "liquid",
"application_method": "inject",
"additives": [
"n_serve"
],
"area_unit": "acre",
"rate_unit": "gallon"
},
{
"date": "2021-05-26",
"name": "urea_ammonium_nitrate_28",
"amount": 4,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "liquid",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "gallon"
},
{
"date": "2021-06-30",
"name": "urea",
"amount": 300,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2022-05-25",
"name": "urea_ammonium_nitrate_28",
"amount": 4,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "liquid",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "gallon"
},
{
"date": "2022-06-08",
"name": "urea",
"amount": 100,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2022-07-13",
"name": "urea",
"amount": 300,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2023-04-26",
"name": "urea",
"amount": 300,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2024-05-25",
"name": "urea_ammonium_nitrate_28",
"amount": 4,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "liquid",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "gallon"
},
{
"date": "2024-06-08",
"name": "urea",
"amount": 100,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2024-07-13",
"name": "urea",
"amount": 300,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
}
]
}
}
]
}
],
"weather_sources": [
"PRISM",
"GLOBAL"
],
"soil_sources": [
"SSURGO",
"GLOBAL"
],
"scenario_type": "baseline"
},
{
"name": "practice_change",
"location": {
"latlon": {
"latitude": 44.5678850871186,
"longitude": -93.6434846029078
},
"area": 71.098,
"area_unit": "acre"
},
"rotations": [
{
"phases": [
{
"start_date": "2019-04-24",
"end_date": "2024-09-18",
"management_events": {
"irrigation": [
{
"date": "2019-06-03",
"water_amount": 19.96691324,
"method": "sprinkler",
"depth": 0
},
{
"date": "2020-05-26",
"water_amount": 19.96691324,
"method": "sprinkler",
"depth": 0
},
{
"date": "2021-06-01",
"water_amount": 19.96691324,
"method": "sprinkler",
"depth": 0
},
{
"date": "2022-05-25",
"water_amount": 19.96691324,
"method": "sprinkler",
"depth": 0
},
{
"date": "2023-04-28",
"water_amount": 19.96691324,
"method": "sprinkler",
"depth": 0
},
{
"date": "2024-06-01",
"water_amount": 19.96691324,
"method": "sprinkler",
"depth": 0
}
],
"till": [
{
"date": "2019-04-24",
"soil_inverted": false,
"depth": 19.05,
"strip_frac": 0.333333333333333
},
{
"date": "2019-10-22",
"soil_inverted": false,
"depth": 17.78
},
{
"date": "2020-04-26",
"soil_inverted": false,
"depth": 6.35
},
{
"date": "2021-05-05",
"soil_inverted": false,
"depth": 17.78
},
{
"date": "2022-10-05",
"soil_inverted": false,
"depth": 6.35
}
],
"cropping": [
{
"start_date": "2019-05-13",
"end_date": "2019-09-18",
"name": "corn",
"reductions": [
{
"date": "2019-09-18",
"type": "grain_harvest"
}
]
},
{
"start_date": "2020-04-27",
"end_date": "2020-10-15",
"name": "corn",
"reductions": [
{
"date": "2020-10-15",
"type": "grain_harvest"
}
]
},
{
"start_date": "2021-05-26",
"end_date": "2021-09-22",
"name": "dry_bean",
"reductions": [
{
"date": "2021-09-22",
"type": "grain_harvest"
}
]
},
{
"start_date": "2021-09-15",
"end_date": "2022-05-04",
"name": "oat"
},
{
"start_date": "2022-05-18",
"end_date": "2022-09-07",
"name": "corn",
"reductions": [
{
"date": "2022-09-07",
"type": "grain_harvest"
}
]
},
{
"start_date": "2022-09-15",
"end_date": "2023-08-08",
"name": "rye",
"reductions": [
{
"date": "2023-08-08",
"custom": {
"frac_grain_removed": 1,
"frac_grain_residue": 0,
"frac_leaf_removed": 0.8,
"frac_leaf_residue": 0,
"frac_stem_residue": 0,
"frac_stem_removed": 0.8,
"frac_root_removed": 0,
"frac_root_residue": 0
}
}
]
},
{
"start_date": "2023-08-16",
"end_date": "2023-08-16",
"name": "oat"
},
{
"start_date": "2023-08-16",
"end_date": "2024-04-25",
"name": "oat"
},
{
"start_date": "2024-05-09",
"end_date": "2024-09-18",
"name": "corn",
"reductions": [
{
"date": "2024-09-18",
"type": "grain_harvest"
}
]
}
],
"application": [
{
"date": "2019-05-13",
"name": "urea_ammonium_nitrate_28",
"amount": 4,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 5.08,
"liq_dry": "liquid",
"application_method": "subsurface",
"area_unit": "acre",
"rate_unit": "gallon"
},
{
"date": "2019-06-08",
"name": "ammonium_sulfate",
"amount": 100,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2019-06-26",
"name": "ammonia_anhydrous",
"amount": 34.95,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 15.24,
"liq_dry": "liquid",
"application_method": "inject",
"additives": [
"n_serve"
],
"area_unit": "acre",
"rate_unit": "gallon"
},
{
"date": "2020-04-27",
"name": "urea_ammonium_nitrate_28",
"amount": 4,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "liquid",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "gallon"
},
{
"date": "2020-06-01",
"name": "ammonium_sulfate",
"amount": 100,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2020-06-16",
"name": "ammonia_anhydrous",
"amount": 46.6,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 15.24,
"liq_dry": "liquid",
"application_method": "inject",
"additives": [
"n_serve"
],
"area_unit": "acre",
"rate_unit": "gallon"
},
{
"date": "2021-05-26",
"name": "urea_ammonium_nitrate_28",
"amount": 4,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "liquid",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "gallon"
},
{
"date": "2021-06-30",
"name": "urea",
"amount": 300,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2022-05-25",
"name": "urea_ammonium_nitrate_28",
"amount": 4,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "liquid",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "gallon"
},
{
"date": "2022-06-08",
"name": "urea",
"amount": 100,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2022-07-13",
"name": "urea",
"amount": 300,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2023-04-26",
"name": "urea",
"amount": 300,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2024-05-09",
"name": "urea_ammonium_nitrate_28",
"amount": 4,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 5.08,
"liq_dry": "liquid",
"application_method": "inject",
"area_unit": "acre",
"rate_unit": "gallon"
},
{
"date": "2024-05-31",
"name": "urea",
"amount": 40,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2024-06-19",
"name": "ammonia_anhydrous",
"amount": 126.73,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 15.24,
"liq_dry": "liquid",
"application_method": "inject",
"additives": [
"n_serve"
],
"area_unit": "acre",
"rate_unit": "gallon"
}
]
}
}
]
}
],
"weather_sources": [
"PRISM",
"GLOBAL"
],
"soil_sources": [
"SSURGO",
"GLOBAL"
],
"scenario_type": "practice_change"
}
],
"reporting_information": {
"start_date": "2023-08-17",
"end_date": "2024-09-18",
"crop_name": "corn",
"crop_yield": 280
}
}'
Response:
{
"data": {
"id": "2574360",
"project_name": "my_project",
"session_name": "Field 1",
"field_request_id": 11962970
},
"message": "Session uploaded"
}
The second field is Field 2. It contains several events between 2019 and 2023, the only difference between the baseline and the practice change scenarios are the dates and amounts of two fertilizer events inside the reporting period (like it should be, because for comparison all the events before the reporting start date must be the same), that is between October 10th 2023 and September 26th 2024. The reporting crop is soybean.
The request to submit the field is the following:
curl -X 'POST' \
'https://api.regrow.ag/dndc-scenarios-service/v0/api/projects/my_project/fields' \
-H 'accept: application/json' \
-H 'x-apikey: <api_key>' \
-H 'Content-Type: application/json' \
-d '{
"session_name": "Field 2",
"scenarios": [
{
"name": "baseline",
"location": {
"latlon": {
"latitude": 44.6875461509203,
"longitude": -93.8756892589201
},
"area": 65.05,
"area_unit": "acre"
},
"rotations": [
{
"phases": [
{
"start_date": "2019-11-03",
"end_date": "2024-09-26",
"management_events": {
"till": [
{
"date": "2019-11-05",
"soil_inverted": false,
"depth": 25.4
},
{
"date": "2020-04-24",
"soil_inverted": false,
"depth": 6.35
},
{
"date": "2020-04-24",
"soil_inverted": false,
"depth": 0
},
{
"date": "2020-10-01",
"soil_inverted": false,
"depth": 17.78
},
{
"date": "2021-04-16",
"soil_inverted": false,
"depth": 6.35
},
{
"date": "2021-10-21",
"soil_inverted": false,
"depth": 25.4
},
{
"date": "2022-05-16",
"soil_inverted": false,
"depth": 6.35
},
{
"date": "2022-05-16",
"soil_inverted": false,
"depth": 0
},
{
"date": "2022-10-01",
"soil_inverted": false,
"depth": 17.78
},
{
"date": "2023-05-01",
"soil_inverted": false,
"depth": 6.35
},
{
"date": "2023-10-10",
"soil_inverted": false,
"depth": 30.48
},
{
"date": "2024-05-14",
"soil_inverted": false,
"depth": 7.62
}
],
"cropping": [
{
"start_date": "2020-04-26",
"end_date": "2020-09-25",
"name": "soybean",
"reductions": [
{
"date": "2020-09-25",
"type": "grain_harvest"
}
]
},
{
"start_date": "2021-04-18",
"end_date": "2021-10-08",
"name": "corn",
"reductions": [
{
"date": "2021-10-08",
"type": "grain_harvest"
}
]
},
{
"start_date": "2022-05-18",
"end_date": "2022-09-27",
"name": "soybean",
"reductions": [
{
"date": "2022-09-27",
"type": "grain_harvest"
}
]
},
{
"start_date": "2023-05-02",
"end_date": "2023-10-09",
"name": "corn",
"reductions": [
{
"date": "2023-10-09",
"type": "grain_harvest"
}
]
},
{
"start_date": "2024-05-15",
"end_date": "2024-09-26",
"name": "soybean",
"reductions": [
{
"date": "2024-09-26",
"type": "grain_harvest"
}
]
}
],
"application": [
{
"date": "2019-11-03",
"name": "ammonium_sulfate",
"amount": 50,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2019-11-03",
"name": "monoammonium_phosphate",
"amount": 110,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2019-11-03",
"name": "potassium_chloride",
"amount": 167,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2020-09-28",
"name": "monoammonium_phosphate",
"amount": 111,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2020-09-28",
"name": "potassium_chloride",
"amount": 167,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2020-09-28",
"name": "sulfate",
"amount": 17,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2021-04-17",
"name": "ammonium_thiosulfate",
"amount": 2.5,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "liquid",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "gallon"
},
{
"date": "2021-04-17",
"name": "urea_ammonium_nitrate_32",
"amount": 22.5,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "liquid",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "gallon"
},
{
"date": "2021-06-06",
"name": "ammonium_thiosulfate",
"amount": 3.8,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "liquid",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "gallon"
},
{
"date": "2021-06-06",
"name": "urea_ammonium_nitrate_32",
"amount": 15.2,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "liquid",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "gallon"
},
{
"date": "2021-10-19",
"name": "di_ammonium_phosphate",
"amount": 65,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2021-10-19",
"name": "potassium_chloride",
"amount": 168,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2021-10-19",
"name": "sulfate",
"amount": 17.5,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2022-09-28",
"name": "di_ammonium_phosphate",
"amount": 177,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2022-09-28",
"name": "potassium_chloride",
"amount": 100,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2022-09-28",
"name": "sulfate",
"amount": 15,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2023-05-05",
"name": "urea_ammonium_nitrate_32",
"amount": 20,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "liquid",
"application_method": "broadcast",
"additives": [
"agrotain"
],
"area_unit": "acre",
"rate_unit": "gallon"
},
{
"date": "2023-06-07",
"name": "ammonium_thiosulfate",
"amount": 5,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "liquid",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "gallon"
},
{
"date": "2023-06-07",
"name": "urea_ammonium_nitrate_32",
"amount": 20,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "liquid",
"application_method": "broadcast",
"additives": [
"agrotain"
],
"area_unit": "acre",
"rate_unit": "gallon"
},
{
"date": "2023-10-19",
"name": "di_ammonium_phosphate",
"amount": 65,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2023-10-19",
"name": "potassium_chloride",
"amount": 168,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2023-10-19",
"name": "sulfate",
"amount": 17.5,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
}
]
}
}
]
}
],
"weather_sources": [
"PRISM",
"GLOBAL"
],
"soil_sources": [
"SSURGO",
"GLOBAL"
],
"scenario_type": "baseline"
},
{
"name": "practice_change",
"location": {
"latlon": {
"latitude": 44.6875461509203,
"longitude": -93.8756892589201
},
"area": 65.05,
"area_unit": "acre"
},
"rotations": [
{
"phases": [
{
"start_date": "2019-11-03",
"end_date": "2024-09-26",
"management_events": {
"till": [
{
"date": "2019-11-05",
"soil_inverted": false,
"depth": 25.4
},
{
"date": "2020-04-24",
"soil_inverted": false,
"depth": 6.35
},
{
"date": "2020-04-24",
"soil_inverted": false,
"depth": 0
},
{
"date": "2020-10-01",
"soil_inverted": false,
"depth": 17.78
},
{
"date": "2021-04-16",
"soil_inverted": false,
"depth": 6.35
},
{
"date": "2021-10-21",
"soil_inverted": false,
"depth": 25.4
},
{
"date": "2022-05-16",
"soil_inverted": false,
"depth": 6.35
},
{
"date": "2022-05-16",
"soil_inverted": false,
"depth": 0
},
{
"date": "2022-10-01",
"soil_inverted": false,
"depth": 17.78
},
{
"date": "2023-05-01",
"soil_inverted": false,
"depth": 6.35
},
{
"date": "2023-10-10",
"soil_inverted": false,
"depth": 30.48
},
{
"date": "2024-05-14",
"soil_inverted": false,
"depth": 7.62
}
],
"cropping": [
{
"start_date": "2020-04-26",
"end_date": "2020-09-25",
"name": "soybean",
"reductions": [
{
"date": "2020-09-25",
"type": "grain_harvest"
}
]
},
{
"start_date": "2021-04-18",
"end_date": "2021-10-08",
"name": "corn",
"reductions": [
{
"date": "2021-10-08",
"type": "grain_harvest"
}
]
},
{
"start_date": "2022-05-18",
"end_date": "2022-09-27",
"name": "soybean",
"reductions": [
{
"date": "2022-09-27",
"type": "grain_harvest"
}
]
},
{
"start_date": "2023-05-02",
"end_date": "2023-10-09",
"name": "corn",
"reductions": [
{
"date": "2023-10-09",
"type": "grain_harvest"
}
]
},
{
"start_date": "2024-05-15",
"end_date": "2024-09-26",
"name": "soybean",
"reductions": [
{
"date": "2024-09-26",
"type": "grain_harvest"
}
]
}
],
"application": [
{
"date": "2019-11-03",
"name": "ammonium_sulfate",
"amount": 50,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2019-11-03",
"name": "monoammonium_phosphate",
"amount": 110,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2019-11-03",
"name": "potassium_chloride",
"amount": 167,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2020-09-28",
"name": "monoammonium_phosphate",
"amount": 111,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2020-09-28",
"name": "potassium_chloride",
"amount": 167,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2020-09-28",
"name": "sulfate",
"amount": 17,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2021-04-17",
"name": "ammonium_thiosulfate",
"amount": 2.5,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "liquid",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "gallon"
},
{
"date": "2021-04-17",
"name": "urea_ammonium_nitrate_32",
"amount": 22.5,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "liquid",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "gallon"
},
{
"date": "2021-06-06",
"name": "ammonium_thiosulfate",
"amount": 3.8,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "liquid",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "gallon"
},
{
"date": "2021-06-06",
"name": "urea_ammonium_nitrate_32",
"amount": 15.2,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "liquid",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "gallon"
},
{
"date": "2021-10-19",
"name": "di_ammonium_phosphate",
"amount": 65,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2021-10-19",
"name": "potassium_chloride",
"amount": 168,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2021-10-19",
"name": "sulfate",
"amount": 17.5,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2022-09-28",
"name": "di_ammonium_phosphate",
"amount": 177,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2022-09-28",
"name": "potassium_chloride",
"amount": 100,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2022-09-28",
"name": "sulfate",
"amount": 15,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2023-05-05",
"name": "urea_ammonium_nitrate_32",
"amount": 20,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "liquid",
"application_method": "broadcast",
"additives": [
"agrotain"
],
"area_unit": "acre",
"rate_unit": "gallon"
},
{
"date": "2023-06-07",
"name": "ammonium_thiosulfate",
"amount": 5,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "liquid",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "gallon"
},
{
"date": "2023-06-07",
"name": "urea_ammonium_nitrate_32",
"amount": 20,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "liquid",
"application_method": "broadcast",
"additives": [
"agrotain"
],
"area_unit": "acre",
"rate_unit": "gallon"
},
{
"date": "2023-10-23",
"name": "monoammonium_phosphate",
"amount": 63,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
},
{
"date": "2023-10-23",
"name": "potassium_chloride",
"amount": 180,
"nutrient_product_type": "basic_inorganic",
"amount_type": "product",
"depth": 0,
"liq_dry": "dry",
"application_method": "broadcast",
"area_unit": "acre",
"rate_unit": "pound"
}
]
}
}
]
}
],
"weather_sources": [
"PRISM",
"GLOBAL"
],
"soil_sources": [
"SSURGO",
"GLOBAL"
],
"scenario_type": "practice_change"
}
],
"reporting_information": {
"start_date": "2023-10-10",
"end_date": "2024-09-26",
"crop_name": "soybean",
"crop_yield": 52.54
}
}'
Response:
{
"data": {
"id": "2574362",
"project_name": "my_project",
"session_name": "Field 2",
"field_request_id": 11962972
},
"message": "Session uploaded"
}
Retrieving results
The results will be generated and go through Regrow's QA process. They can be retrieved via a GET request to endpoint /api/project_level_scope_1, where we can select which credit share type we want to see, in this case credit_share_weighted:
curl -X 'GET' \
'https://api.regrow.ag/dndc-scenarios-service/v0/api/project_level_scope_1?project_name=my_project&signed_url=false&credit_share_type=credit_share_weighted' \
-H 'accept: application/json' \
-H 'x-apikey: <api_key>'
Response (uncertainty values removed for visibility):
{
"project_level": {
"reporting_information": {
"start_date": "2023-08-17",
"end_date": "2024-09-26"
},
"credit": {
"number_of_fields": 2,
"number_of_acres": 136.148,
"reversible_credits": {
"mean": 28.181573980706634,
"standard_deviation": 89.83890565935415,
"reporting_percentile": 30,
"uncertainty_distribution": [
25.315682376533914,
...
168.18942929238284
],
"credit": -19.21910806983884
},
"non_reversible_credits": {
"mean": -12.630656582314842,
"standard_deviation": 88.15497839974779,
"reporting_percentile": 30,
"uncertainty_distribution": [
-17.850840538374765,
...
131.74521083012095
],
"credit": -58.9581616377585
},
"reversible_credit": -19.21910806983884,
"non_reversible_credit": -58.9581616377585,
"total_credit": -78.17726970759733
}
},
"field_level": {
"11962970": {
"reporting_information": {
"start_date": "2023-08-17",
"end_date": "2024-09-18",
"acres": 71.098
},
"credit_share": -64.76045379737866,
"field_name": "Field 1"
},
"11962972": {
"reporting_information": {
"start_date": "2023-10-10",
"end_date": "2024-09-26",
"acres": 65.05
},
"credit_share": -13.416815910218672,
"field_name": "Field 2"
}
}
}