# paths./post.post.summary
POST Request Federal Crop Insurance Quoter

# paths./post.post.description
Please note, this is the trial version of this API with limited usage. Please purchase a subscription key for continued use.

BUY

DEMO

The Federal Crop Insurance Quoter API is used to calculate insurance premiums for Yield Protection, Revenue Protection, and Revenue Protection with Harvest Price exclusion, along with their area coverage alternatives.

Premium Calculator used in Ag-Analytics DataLayers.

Documentation

Notebook

Github Repo

Click the Jupyter Notebook Static Sample to view a static rendition of this APIs Jupyter Notebook.
Click the Jupyter Notebook Github Repo to access the Jupyter Notebook .ipynb files and
instructions needed in order to run this APIs Jupyter Notebook.

Request Parameters ▼

Request Parameters

Name

Type

Description

FIPS

int

The FIPS code of a county (e.g. 17019).
See county FIPS codes for full listing.

CropCode

int

The code for a crop (e.g. corn's crop code is 41).
See Crop Codes Summary for full listing.

Type

int

The code for the type of a crop (e.g. corn type grain is 16).
See Crop Codes Summary for full listing.

Practice

int

The code for the practice type of a crop (e.g. non-irrigated is 3).
See Crop Codes Summary for full listing.

PreventedPlanning

int

An integer in the range [0,2]. 0 = Standard, 1 = Plus 5%, 2 = Plus 1

UseTAYield

int

An integer in the range [0,1]. 1 = Use Trend-Adjusted Yield, 0 = do not use
Trend-Adjusted Yield

SharePercentage

double

A float indicating the insured share percent, in the range [0.001, 1]

TrendAdjustedYield

double

A double specifying the Trend-Adjusted Yield

Acres

double

A double specifying the acreage.

Year

int

An integer specifying the year that the calculation should take place for.

APHYield

double

A double specifying the Actual Production History Yield

Price

double

A double specifying the projected crop price

Volatility

double

A double specifying the volatility of the crop

ReturnParameters

int

If value is 1, parameters for the steps of the premium calculation
are included in the response. If value is 0, parameters from the
premium calculation are not included in the response.

HighRiskCode

String

Subcounty high risk code that the insured field is located in, and is
relevant to the specified crop, practice, and type (e.g. 'AAA').

Response Parameters ▼

Response Parameters

Name

Type

Description

Premium

double[8 , 9]

The eight arrays are for coverage levels 50% - 85%, index corresponding the
ascending coverage. Within each array, index values are as shown:

double[*, 0] → RP Optional, double[*, 1] → RP Basic, double[*, 2] → RP Enterprise,
double[*, 3] → RPHPE Optional, double[*, 4] → RPHPE Basic, double[*, 5] → RPHPE Enterprise,
double[*, 6] → YP Optional, double[*, 7] → YP Basic, double[*, 8] → YP Enterprise

PremiumAllAcres

double[8 , 9]

The premium per acre from the ‘Premium’ value multiplied by the acreage.
Has same index structure as ‘Premium’.

Subsidy

double[8 , 2]

The eight arrays are for coverage levels 50% - 85%, index corresponding the ascending coverage.
Within each array, index arrays are as follows:

double[* , 0] → Subsidy rate for Basic/Optional units
double[* , 1] → Subsidy rate for Enterprise units.

Liability

double[8 , 1]

The eight arrays are for coverage levels 50% - 85%, index corresponding the ascending coverage.
Each value is the liability at that coverage level.

TotalPremium

double[8 , 9]

Same structure as ‘Premium’. Values are the premiums before the subtracting the subsidy.

TotalPremiumAllAcres

double[8 , 9]

The total premium per acre from ‘TotalPremium’ multiplied by the acreage amount.
Has same index structure as ‘Premium’.

SubsidyAmount

double[8 , 9]

Same index structure as ‘Premium’. Values are the dollar amount per acre that are
subtracted from the ‘TotalPremium’ to give you the ‘Premium’.

SubsidyAmountAllAcres

double[8 , 9]

The subsidy amount per acre from ‘SubsidyAmountAllAcres’ multiplied by acreage
amount. Has same index structure as ‘Premium’.

Guarantee

double[8 , 3]

The eight arrays are for 50-85% coverage levels with index corresponding to ascending coverage level.
The values in each array are as follows:

double[* , 0] → Minimum Revenue Guarantee
double[* , 1] → Revenue guarantee
double[* , 2] → Yield guarantee

CountyLevelPrem

double[5, 9]

The five arrays are for coverage levels index corresponding the ascending coverage.
The values in each list match the index structure in ‘Premium’.

CountyLevelGuarantee

double[5 , 3]

The five arrays are for coverage levels index corresponding the ascending coverage.
The values in each array are as follows:
double[*, 0] → Minimum Revenue Guarantee
double[*, 1] → Revenue guarantee
double[*, 2] → Yield guarantee

CountyDataAvailable

bool

Indicates whether county level data is available for the input given.

Plans

Int[]

Array of unspecified length, indicating what insurance plans are available for the inputs given.

Parameters

string

Array of unspecified length, indicating what insurance plans are available for the inputs given.
Coverage levels (e.g. ‘50%’)
Policy (‘rp’, ‘yp’, ‘rphpe’)
Unit (‘Basic’, ‘Optional’, ‘Enterprise’)
Parameters (Parameters of the equation)