Skip to content Skip to main navigation Skip to footer
Fieldprint Platform Help

Empowering the Agricultural Supply Chain

Fieldprint API — /v5/Endpoints

Access to the Fieldprint Platform and API requires Field to Market membership and an active Data Management Licensing Agreement. Learn more about membership and our data partner program to get started. Access to the Fieldprint API requires an authorized API key issued by Field to Market.

The Fieldprint Platform API v5 provides a comprehensive set of endpoints for calculating sustainability metrics, generating field data, and accessing reference data used across the platform. This page serves as a complete index of all available API endpoints.

Getting Started

Base URL https://api.fieldtomarket.org/v5/
Authentication API Key (provided by Field to Market). Include as a Bearer token in the Authorization header.
Content-Type application/json (for POST requests)
Response Format JSON
Endpoint Discovery: You can retrieve this list of endpoints programmatically by calling GET https://api.fieldtomarket.org/v5/EndPoints, which returns a JSON array of all available endpoint URLs.

Calculators & Analysis

These endpoints perform sustainability calculations, generate scaled benchmark scores, and evaluate SAI Platform FSA equivalency.

Method Endpoint Description
POST /v5/Calculator Submit complete crop interval data and calculate all Fieldprint sustainability metric results (Land Use, Irrigation Water Use, Water Quality, Energy Use, Greenhouse Gas, Soil Carbon, Soil Conservation, Biodiversity).
POST /v5/CalculatorReport Generate a PDF report of Fieldprint Analysis results for a crop interval.
POST /v5/ScaledBenchmarks Get scaled sustainability scores (0–100) comparing a field’s metrics against state and national benchmarks. Powers the Fieldprint Analysis spider chart. View documentation
POST /v5/SaiCalculator Evaluate 22 FSA survey questions and return the SAI Platform FSA Equivalency determination. View documentation

Field Data

These endpoints generate pre-filled field and crop interval data based on field geometry, regional agronomic defaults, and USDA data sources.

Method Endpoint Description
POST /v5/FieldData/PrefillCropIntervals Generate complete crop intervals with default management activities for specific years you specify. Allows control over crop type, yield, tillage, irrigation, cover crop, and nitrogen inputs. View documentation
POST /v5/FieldData/PrefillFieldHistory Generate a complete multi-year crop history (2008–present) from USDA Cropland Data Layer data based on field geometry. View documentation
POST /v5/FieldData/SSURGO Retrieve USDA SSURGO soil survey data (soil texture, slope, slope length, clay content) for a given field geometry.

Reference Data — Crops & Operations

These GET endpoints return lookup tables of valid IDs and values used when constructing /v5/Calculator request payloads. All reference data endpoints require authentication but take no input parameters.

Method Endpoint Description
GET /v5/ReferenceData/Crops All supported crop types with IDs, names, yield units, and crop group classifications.
GET /v5/ReferenceData/PlantingOperations Planting operation types (e.g., conventional planter, no-till drill) with IDs and diesel use estimates.
GET /v5/ReferenceData/HarvestOperations Harvest operation types (e.g., combine, forage harvester) with IDs and diesel use estimates.
GET /v5/ReferenceData/TillageOperations Tillage operation types (e.g., moldboard plow, chisel plow, disk) with IDs and diesel use estimates.
GET /v5/ReferenceData/TillageClasses Tillage intensity classifications: No-Till (85% residue), Strip-Till (70%), Reduced Till (30%), Conventional (<10%).
GET /v5/ReferenceData/SeedingRates Default seeding rates by crop type.
GET /v5/ReferenceData/ResidueManagementOperations Residue management operation types and classifications.
GET /v5/ReferenceData/SprayingCropProtectantOperations Spraying and crop protectant application operation types.
GET /v5/ReferenceData/DryBeansVarieties Dry bean variety classifications.
GET /v5/ReferenceData/AssessmentReports Available assessment report types and configurations.

Reference Data — Nutrients & Fertilizers

Method Endpoint Description
GET /v5/ReferenceData/Fertilizers Commercial fertilizer products with nutrient content (N-P-K-S percentages).
GET /v5/ReferenceData/CommercialFertilizerOperations Fertilizer application operation types with IDs and diesel use estimates.
GET /v5/ReferenceData/OtherNutrientProducts Non-commercial nutrient products (e.g., compost, biosolids).
GET /v5/ReferenceData/Nutrient4RS 4R Nutrient Stewardship practice classifications (Right Source, Rate, Time, Place).
GET /v5/ReferenceData/NutrientRatePractices Nutrient rate determination practice types.
GET /v5/ReferenceData/ManureTypes Manure type classifications with nutrient content.
GET /v5/ReferenceData/ManureAnimalSources Animal source types for manure applications.
GET /v5/ReferenceData/ManureApplicationOperations Manure application method types with diesel use estimates.
GET /v5/ReferenceData/ManureLimits Manure application rate limits and constraints.

Reference Data — Phosphorus & Soil

Method Endpoint Description
GET /v5/ReferenceData/PSoilTestLevel Phosphorus soil test level classifications.
GET /v5/ReferenceData/PDrawdownStrategies Phosphorus drawdown strategy options.
GET /v5/ReferenceData/PMultiYearApp Multi-year phosphorus application options.
GET /v5/ReferenceData/SoilTextures USDA soil texture classifications (e.g., clay, loam, sand).

Reference Data — Cover Crops

Method Endpoint Description
GET /v5/ReferenceData/CoverCrops Supported cover crop species with IDs and classifications.
GET /v5/ReferenceData/CoverCropEstablishTimings Cover crop establishment timing options relative to cash crop.
GET /v5/ReferenceData/CoverCropGrowth Cover crop growth stage classifications.
GET /v5/ReferenceData/CoverCropTerminationOperations Cover crop termination method types (e.g., herbicide, roller-crimper, tillage).

Reference Data — Irrigation & Water

Method Endpoint Description
GET /v5/ReferenceData/WaterSources Irrigation water source types (e.g., groundwell, surface water, reclaimed).
GET /v5/ReferenceData/IrrigationMethods Irrigation application methods (e.g., center pivot, drip, flood).
GET /v5/ReferenceData/IrrigationEnergySources Energy source types for irrigation pumping (e.g., electric, diesel, natural gas).
GET /v5/ReferenceData/TileDrainage Tile drainage configuration options.

Reference Data — Rice

Method Endpoint Description
GET /v5/ReferenceData/RiceWaterManagementTypes Rice paddy water management regime types for GHG calculations.
GET /v5/ReferenceData/RicePreseasonWaterRegimes Preseason water regime classifications for rice fields.

Reference Data — Conservation & Land Use

Method Endpoint Description
GET /v5/ReferenceData/ConservationPractices Conservation practice types (e.g., buffer strips, terraces, waterways).
GET /v5/ReferenceData/LandConversionTypes Land use conversion types for GHG and soil carbon calculations.
GET /v5/ReferenceData/ForestGenusTypes Forest genus types for land conversion and biodiversity context.
GET /v5/ReferenceData/GrasslandManagementTypes Grassland management type classifications.
GET /v5/ReferenceData/WildlifeHabitat Wildlife habitat practice types for biodiversity metric.
GET /v5/ReferenceData/IntegratedPestManagement Integrated Pest Management (IPM) practice classifications.
GET /v5/ReferenceData/TimeHorizons Time horizon options for certain metric calculations.

Reference Data — Other

Method Endpoint Description
GET /v5/ReferenceData/CottonMoisture Cotton moisture content classifications for yield adjustments.
GET /v5/ReferenceData/DryingLocations Grain drying location types (e.g., on-farm, commercial elevator).
GET /v5/ReferenceData/DryingSystems Grain drying system types and energy source classifications.
GET /v5/ReferenceData/TransportationFuelTypes Fuel types for crop transportation (e.g., diesel, gasoline, biodiesel).

Utility

Method Endpoint Description
GET /v5/EndPoints Returns a JSON array of all available API endpoint URLs. Use this to programmatically discover the full API surface.

Example: Calling the EndPoints Endpoint

GET https://api.fieldtomarket.org/v5/EndPoints
Authorization: Bearer {your_api_key}

Response (truncated):

[
  "https://api.fieldtomarket.org/v5/Calculator",
  "https://api.fieldtomarket.org/v5/CalculatorReport",
  "https://api.fieldtomarket.org/v5/EndPoints",
  "https://api.fieldtomarket.org/v5/FieldData/PrefillCropIntervals",
  "https://api.fieldtomarket.org/v5/FieldData/PrefillFieldHistory",
  "https://api.fieldtomarket.org/v5/FieldData/SSURGO",
  "https://api.fieldtomarket.org/v5/ReferenceData/Crops",
  // ... 44 additional reference data endpoints ...
  "https://api.fieldtomarket.org/v5/SaiCalculator",
  "https://api.fieldtomarket.org/v5/ScaledBenchmarks"
]

Usage Notes

Authentication: All endpoints require an API key issued by Field to Market. Include it as a Bearer token: Authorization: Bearer {your_api_key}. Contact support@fieldtomarket.org if you need to request or rotate your key.
Reference Data Endpoints: All /v5/ReferenceData/* endpoints are GET requests that take no input parameters. They return JSON arrays of valid IDs and labels. Use these to populate dropdowns or validate input values before submitting to the Calculator or FieldData endpoints.
Typical Integration Workflow: Most QDMP integrations follow this pattern: (1) call Reference Data endpoints to retrieve valid crop IDs, operation IDs, and other lookup values; (2) use PrefillFieldHistory or PrefillCropIntervals to generate baseline data from field geometry; (3) submit finalized crop interval data to /v5/Calculator; (4) retrieve scaled scores via /v5/ScaledBenchmarks.

Reach out to support@fieldtomarket.org with additional questions on implementation.


Was This Article Helpful?

0
Related Articles