curl --request POST 'https://esa-v2.acreblitz.com/api/v2/process-field' \
--header "X-API-Key: $ACREBLITZ_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"provider_id": "your-provider",
"account_id": "your-account",
"provider_field_id": "north-field",
"field_name": "North field",
"field_boundary": {
"type": "Feature",
"properties": {},
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
-95.404,
43.102
],
[
-95.392,
43.102
],
[
-95.392,
43.11
],
[
-95.404,
43.11
],
[
-95.404,
43.102
]
]
]
}
},
"year": 2026,
"include_mitigation_options": true
}'
{
"success": true,
"provider_field_id": "north-field",
"year": 2026,
"steps": {
"spatial": {
"success": true
},
"soil": {
"success": true,
"data": {
"status": "reused"
}
},
"mitigations": {
"success": true
}
},
"summary": {
"pula_count": 0,
"soil_available": true,
"mitigations_applied_count": 2,
"total_points": 3
}
}
Field and soil
Process a field
Save a field with soil analysis and automatic runoff credits
POST
/
api
/
v2
/
process-field
curl --request POST 'https://esa-v2.acreblitz.com/api/v2/process-field' \
--header "X-API-Key: $ACREBLITZ_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"provider_id": "your-provider",
"account_id": "your-account",
"provider_field_id": "north-field",
"field_name": "North field",
"field_boundary": {
"type": "Feature",
"properties": {},
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
-95.404,
43.102
],
[
-95.392,
43.102
],
[
-95.392,
43.11
],
[
-95.404,
43.11
],
[
-95.404,
43.102
]
]
]
}
},
"year": 2026,
"include_mitigation_options": true
}'
{
"success": true,
"provider_field_id": "north-field",
"year": 2026,
"steps": {
"spatial": {
"success": true
},
"soil": {
"success": true,
"data": {
"status": "reused"
}
},
"mitigations": {
"success": true
}
},
"summary": {
"pula_count": 0,
"soil_available": true,
"mitigations_applied_count": 2,
"total_points": 3
}
}
Save a field with soil analysis and automatic runoff credits.
Request
string
required
Your assigned provider identifier.
string
required
Your account identifier.
string
required
Required external field identifier.
string
required
Field name displayed in the portal and compliance reports.
object
required
GeoJSON Feature with Polygon/MultiPolygon in EPSG:4326; uses single-check boundary validation.
integer
Year for automatic runoff credits, 1900–2200; defaults to the current UTC year.
boolean
default:"false"
Include the EPA runoff option tree with selected measures.
Processing behavior
This endpoint saves a field, its processed soil, and automatic annual runoff credits. It does not create an application or run a product-specific assessment. Soil must complete before this update is saved; soil failure leaves the existing field data intact.Response
The response includes yourprovider_field_id, year, portal link fields, soil_data, counties, pulas, mitigations_applied, steps, and summary. mitigation_options is null unless requested. steps.soil.data.status distinguishes reused from fetched; fetched can still reuse soil source data for the area.
The example shows selected fields only.
curl --request POST 'https://esa-v2.acreblitz.com/api/v2/process-field' \
--header "X-API-Key: $ACREBLITZ_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"provider_id": "your-provider",
"account_id": "your-account",
"provider_field_id": "north-field",
"field_name": "North field",
"field_boundary": {
"type": "Feature",
"properties": {},
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
-95.404,
43.102
],
[
-95.392,
43.102
],
[
-95.392,
43.11
],
[
-95.404,
43.11
],
[
-95.404,
43.102
]
]
]
}
},
"year": 2026,
"include_mitigation_options": true
}'
{
"success": true,
"provider_field_id": "north-field",
"year": 2026,
"steps": {
"spatial": {
"success": true
},
"soil": {
"success": true,
"data": {
"status": "reused"
}
},
"mitigations": {
"success": true
}
},
"summary": {
"pula_count": 0,
"soil_available": true,
"mitigations_applied_count": 2,
"total_points": 3
}
}
Errors
Field processing can return409 DUPLICATE_FIELD, FIELD_OWNERSHIP_CONFLICT, PROCESSING_CONFLICT, or FIELD_CHANGED, and 503 PORTAL_SAS_UNCONFIGURED when signed portal links are unavailable.
All routes can also return authentication, validation, rate-limit, and dependency errors. Use the error catalog and examples to choose a retry or correction. Keep X-Request-ID when present.