Program Metadata
API Documentation for GET /programs
Note: This document is a draft proposal and is subject to change. It is intended to provide an initial framework for discussion and refinement.
Description
The GET /programs endpoint provides structured data for programs offered by suppliers. Each program includes detailed information about its offers, associated incentives, and earnable SKUs.
CURL Request Example
curl --location GET 'https://dev.calc.ag/programs?program_supplier_key=corteva&time_frame=2024' \
--header 'x-api-key: your-api-key' \
--header 'participant-key: agtegra' \
--header 'Content-Type: application/json'
Example Response
{
"data": [
{
"key": "corteva.2024.national.enlist_retail",
"label": "2023 - 2024 Corteva → National → Enlist Retail",
"summary": "The Enlist Retail Program of Boost Brands remotes use of a multiple modes of action and yield enhancing products across a wide range of acres",
"description": "Retailer must purchase a minimum of $75,000 gross EDI of qualifying products. AND Retailer must purchase EDI equal to or greater than $75,000 gross EDI of qualifying products. Retailer will earn 3% on EDI volume of Enlist One and Enlist Duo reported from Oct. 1, 2023 through July 31, 2024 See program sheet for qualifying products.",
"attributes": [
{
"type": "program_sheet",
"value": "2023-2024 Corteva Retail Offer Book_Digital.pdf",
"label": ""
}
],
"time_frame": "2024",
"key_dates": [],
"start_date": "2022-10-01",
"end_date": "2024-09-30",
"transaction_types": [
"retailer_purchases_from_distribution"
],
"program_supplier_key": "corteva",
"version": "2025-01-01--01",
"qualifications": [],
"qualifier": null,
"external_ids": [],
"offers": [
{
"key": "corteva.2024.national.enlist_retail.boost_brands",
"label": "2023 - 2024 Corteva → National → Enlist Retail → Boost Brands",
"attributes": [],
"sku_keys": [
"aproach_fungicide_110_gal_5587522",
"aproach_fungicide_2.5_gal_5009749",
"aproach_prima_fungicide_110_gal_5009764",
"aproach_prima_fungicide_2.5_gal_5591827",
"aproach_prima_fungicide_250_gal_5038973",
"bexfond_fungicide_2.5_gal_1410326",
"delegate_wg_insecticide_26_oz_wt_5039877",
"delegate_wg_insecticide_64_oz_wt_5715812",
"enlist_duo_herbicide_2.5_gal_5022294",
"enlist_duo_herbicide_250_gal_5002802",
"enlist_duo_herbicide_bulk_1004513",
"enlist_one_herbicide_125_gal_9999006",
"enlist_one_herbicide_2.5_gal_5038807",
"enlist_one_herbicide_250_gal_5056513",
"enlist_one_herbicide_bulk_5019426",
"entrust_sc_insecticide_1_qt_5615171",
"fontelis_fungicide_2.5_gal_5056614",
"fontelis_fungicide_80_oz_5582166",
"hearken_insecticide_1_gal_1397912",
"instinct_nxtgen_nitrogen_stabilizer_2.5_gal_5051049",
"instinct_nxtgen_nitrogen_stabilizer_250_gal_5051054",
"instinct_nxtgen_nitrogen_stabilizer_bulk_1006191",
"intrepid_2f_insecticide_1_gal_5593341",
"intrepid_edge_insecticide_1_gal_5587581",
"kyro_herbicide_2.5_gal_5774070",
"kyro_herbicide_250_gal_5774680",
"kyro_herbicide_bulk_1491813",
"n_serve_24_nitrogen_stabilizer_bulk_5002455",
"pixxaro_ec_herbicide_120_gal_5645567",
"pixxaro_ec_herbicide_2.5_gal_5030857",
"quelex_herbicide_1.875_lb_5600953",
"radiant_sc_insecticide_1_gal_5591885",
"radiant_sc_insecticide_1_qt_5590571",
"resicore_herbicide_2.5_gal_5056108",
"resicore_herbicide_250_gal_5008985",
"resicore_xl_herbicide_2.5_gal_5675459",
"rezuvant_herbicide_2.5_gal_5625056",
"rezuvant_herbicide_bulk_1273617",
"ridgeback_insecticide_120_gal_5623723",
"ridgeback_insecticide_2.5_gal_5621878",
"salibro_nematicide_2.5_gal_5602263",
"sosdia_stress_abiotic_stress_mitigator_2.5_gal_1439171",
"tarzec_herbicide_5_lb_5618756",
"transform_wg_insecticide_3_lb_5051645",
"transform_wg_insecticide_8_lb_5036392",
"utrisha_n_biostimulant_12.5_lb_1409466",
"utrisha_n_biostimulant_50_oz_wt_1387825",
"utrisha_p_biostimulant_2.5_gal_5792446",
"viatude_fungicide_2.5_gal_5772541"
],
"time_periods": [
{
"key": "previous_season",
"label": null,
"start_date": "2022-10-01",
"start_date_label": null,
"end_date": "2023-09-30",
"end_date_label": null
},
{
"key": "incentive_period",
"label": null,
"start_date": "2023-10-01",
"start_date_label": null,
"end_date": "2024-07-31",
"end_date_label": null
},
{
"key": "current_season",
"label": null,
"start_date": "2023-10-01",
"start_date_label": null,
"end_date": "2024-09-30",
"end_date_label": null
}
],
"transaction_types": [
"retailer_purchases_from_distribution"
],
"strategy_key": "standard",
"calculator_key": "percent_of_amount",
"qualifications": [
{
"type": "yoy_amount_index",
"key": "2023_2024_yoy_amount_index_qualification",
"label": "Percent of prior year sales",
"operator": "greater_than_or_equal_to",
"value": 1.1,
"numerator": {
"filters": [
{
"period_key": "current_season",
"sku_keys": [
"aproach_fungicide_110_gal_5587522",
"aproach_fungicide_2.5_gal_5009749",
"aproach_prima_fungicide_110_gal_5009764",
"aproach_prima_fungicide_2.5_gal_5591827",
"aproach_prima_fungicide_250_gal_5038973",
"bexfond_fungicide_2.5_gal_1410326",
"delegate_wg_insecticide_26_oz_wt_5039877",
"delegate_wg_insecticide_64_oz_wt_5715812",
"entrust_sc_insecticide_1_qt_5615171",
"fontelis_fungicide_2.5_gal_5056614",
"fontelis_fungicide_80_oz_5582166",
"hearken_insecticide_1_gal_1397912",
"instinct_nxtgen_nitrogen_stabilizer_2.5_gal_5051049",
"instinct_nxtgen_nitrogen_stabilizer_250_gal_5051054",
"instinct_nxtgen_nitrogen_stabilizer_bulk_1006191",
"intrepid_2f_insecticide_1_gal_5593341",
"intrepid_edge_insecticide_1_gal_5587581",
"kyro_herbicide_2.5_gal_5774070",
"kyro_herbicide_250_gal_5774680",
"kyro_herbicide_bulk_1491813",
"n_serve_24_nitrogen_stabilizer_bulk_5002455",
"pixxaro_ec_herbicide_120_gal_5645567",
"pixxaro_ec_herbicide_2.5_gal_5030857",
"quelex_herbicide_1.875_lb_5600953",
"radiant_sc_insecticide_1_gal_5591885",
"radiant_sc_insecticide_1_qt_5590571",
"resicore_herbicide_2.5_gal_5056108",
"resicore_herbicide_250_gal_5008985",
"resicore_xl_herbicide_2.5_gal_5675459",
"rezuvant_herbicide_2.5_gal_5625056",
"rezuvant_herbicide_bulk_1273617",
"ridgeback_insecticide_120_gal_5623723",
"ridgeback_insecticide_2.5_gal_5621878",
"salibro_nematicide_2.5_gal_5602263",
"sosdia_stress_abiotic_stress_mitigator_2.5_gal_1439171",
"tarzec_herbicide_5_lb_5618756",
"transform_wg_insecticide_3_lb_5051645",
"transform_wg_insecticide_8_lb_5036392",
"utrisha_n_biostimulant_12.5_lb_1409466",
"utrisha_n_biostimulant_50_oz_wt_1387825",
"utrisha_p_biostimulant_2.5_gal_5792446",
"viatude_fungicide_2.5_gal_5772541"
],
"transaction_type": "retailer_purchases_from_distribution"
}
]
},
"denominator": {
"filters": [
{
"period_key": "previous_season",
"sku_keys": [
"aproach_fungicide_110_gal_5587522",
"aproach_fungicide_2.5_gal_5009749",
"aproach_prima_fungicide_110_gal_5009764",
"aproach_prima_fungicide_2.5_gal_5591827",
"aproach_prima_fungicide_250_gal_5038973",
"bexfond_fungicide_2.5_gal_1410326",
"delegate_wg_insecticide_26_oz_wt_5039877",
"delegate_wg_insecticide_64_oz_wt_5715812",
"entrust_sc_insecticide_1_qt_5615171",
"fontelis_fungicide_2.5_gal_5056614",
"fontelis_fungicide_80_oz_5582166",
"hearken_insecticide_1_gal_1397912",
"instinct_nxtgen_nitrogen_stabilizer_2.5_gal_5051049",
"instinct_nxtgen_nitrogen_stabilizer_250_gal_5051054",
"instinct_nxtgen_nitrogen_stabilizer_bulk_1006191",
"intrepid_2f_insecticide_1_gal_5593341",
"intrepid_edge_insecticide_1_gal_5587581",
"kyro_herbicide_2.5_gal_5774070",
"kyro_herbicide_250_gal_5774680",
"kyro_herbicide_bulk_1491813",
"n_serve_24_nitrogen_stabilizer_bulk_5002455",
"pixxaro_ec_herbicide_120_gal_5645567",
"pixxaro_ec_herbicide_2.5_gal_5030857",
"quelex_herbicide_1.875_lb_5600953",
"radiant_sc_insecticide_1_gal_5591885",
"radiant_sc_insecticide_1_qt_5590571",
"resicore_herbicide_2.5_gal_5056108",
"resicore_herbicide_250_gal_5008985",
"resicore_xl_herbicide_2.5_gal_5675459",
"rezuvant_herbicide_2.5_gal_5625056",
"rezuvant_herbicide_bulk_1273617",
"ridgeback_insecticide_120_gal_5623723",
"ridgeback_insecticide_2.5_gal_5621878",
"salibro_nematicide_2.5_gal_5602263",
"sosdia_stress_abiotic_stress_mitigator_2.5_gal_1439171",
"tarzec_herbicide_5_lb_5618756",
"transform_wg_insecticide_3_lb_5051645",
"transform_wg_insecticide_8_lb_5036392",
"utrisha_n_biostimulant_12.5_lb_1409466",
"utrisha_n_biostimulant_50_oz_wt_1387825",
"utrisha_p_biostimulant_2.5_gal_5792446",
"viatude_fungicide_2.5_gal_5772541"
],
"transaction_type": "retailer_purchases_from_distribution"
}
]
}
},
{
"type": "aggregated_amount",
"key": "initial_period_minimum_qualification",
"label": "Minimum $75,000 to qualify",
"operator": "greater_than_or_equal_to",
"value": 75000.0,
"filters": [
{
"period_key": "current_season",
"sku_keys": [
"aproach_fungicide_110_gal_5587522",
"aproach_fungicide_2.5_gal_5009749",
"aproach_prima_fungicide_110_gal_5009764",
"aproach_prima_fungicide_2.5_gal_5591827",
"aproach_prima_fungicide_250_gal_5038973",
"bexfond_fungicide_2.5_gal_1410326",
"delegate_wg_insecticide_26_oz_wt_5039877",
"delegate_wg_insecticide_64_oz_wt_5715812",
"entrust_sc_insecticide_1_qt_5615171",
"fontelis_fungicide_2.5_gal_5056614",
"fontelis_fungicide_80_oz_5582166",
"hearken_insecticide_1_gal_1397912",
"instinct_nxtgen_nitrogen_stabilizer_2.5_gal_5051049",
"instinct_nxtgen_nitrogen_stabilizer_250_gal_5051054",
"instinct_nxtgen_nitrogen_stabilizer_bulk_1006191",
"intrepid_2f_insecticide_1_gal_5593341",
"intrepid_edge_insecticide_1_gal_5587581",
"kyro_herbicide_2.5_gal_5774070",
"kyro_herbicide_250_gal_5774680",
"kyro_herbicide_bulk_1491813",
"n_serve_24_nitrogen_stabilizer_bulk_5002455",
"pixxaro_ec_herbicide_120_gal_5645567",
"pixxaro_ec_herbicide_2.5_gal_5030857",
"quelex_herbicide_1.875_lb_5600953",
"radiant_sc_insecticide_1_gal_5591885",
"radiant_sc_insecticide_1_qt_5590571",
"resicore_herbicide_2.5_gal_5056108",
"resicore_herbicide_250_gal_5008985",
"resicore_xl_herbicide_2.5_gal_5675459",
"rezuvant_herbicide_2.5_gal_5625056",
"rezuvant_herbicide_bulk_1273617",
"ridgeback_insecticide_120_gal_5623723",
"ridgeback_insecticide_2.5_gal_5621878",
"salibro_nematicide_2.5_gal_5602263",
"sosdia_stress_abiotic_stress_mitigator_2.5_gal_1439171",
"tarzec_herbicide_5_lb_5618756",
"transform_wg_insecticide_3_lb_5051645",
"transform_wg_insecticide_8_lb_5036392",
"utrisha_n_biostimulant_12.5_lb_1409466",
"utrisha_n_biostimulant_50_oz_wt_1387825",
"utrisha_p_biostimulant_2.5_gal_5792446",
"viatude_fungicide_2.5_gal_5772541"
],
"transaction_type": "retailer_purchases_from_distribution"
}
]
}
],
"qualifier": "initial_period_minimum_qualification AND 2023_2024_yoy_amount_index_qualification",
"incentives": [
{
"key": "",
"label": "",
"rates": [
{
"sku_key": "enlist_duo_herbicide_2.5_gal_5022294",
"rate": 3.0,
"measure": "percent"
},
{
"sku_key": "enlist_duo_herbicide_250_gal_5002802",
"rate": 3.0,
"measure": "percent"
},
{
"sku_key": "enlist_duo_herbicide_bulk_1004513",
"rate": 3.0,
"measure": "percent"
},
{
"sku_key": "enlist_one_herbicide_125_gal_9999006",
"rate": 3.0,
"measure": "percent"
},
{
"sku_key": "enlist_one_herbicide_2.5_gal_5038807",
"rate": 3.0,
"measure": "percent"
},
{
"sku_key": "enlist_one_herbicide_250_gal_5056513",
"rate": 3.0,
"measure": "percent"
},
{
"sku_key": "enlist_one_herbicide_bulk_5019426",
"rate": 3.0,
"measure": "percent"
}
],
"period_key": "incentive_period",
"transaction_type": "retailer_purchases_from_distribution"
}
]
}
]
}
],
"errors": []
}