ESA Check - AcreBlitz API

ESA Check

curl --request POST \
  --url https://esa.acreblitz.com/api/v1/esa-check \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "account_id": "<string>",
  "provider_id": "<string>",
  "field_name": "<string>",
  "application_id": "<string>",
  "application_method": "<string>",
  "application_date": "<string>",
  "field_boundary": {},
  "products": [
    {}
  ],
  "crop": [
    {}
  ],
  "pest": [
    {}
  ],
  "provider_field_id": "<string>",
  "user_email": "<string>",
  "gpa": 123,
  "include_geometry": true,
  "buffer_distance_miles": 123,
  "droplet_size": "<string>",
  "boom_height": "<string>",
  "include_soil_analysis": true,
  "include_mitigations": true
}
'

import requests

url = "https://esa.acreblitz.com/api/v1/esa-check"

payload = {
    "account_id": "<string>",
    "provider_id": "<string>",
    "field_name": "<string>",
    "application_id": "<string>",
    "application_method": "<string>",
    "application_date": "<string>",
    "field_boundary": {},
    "products": [{}],
    "crop": [{}],
    "pest": [{}],
    "provider_field_id": "<string>",
    "user_email": "<string>",
    "gpa": 123,
    "include_geometry": True,
    "buffer_distance_miles": 123,
    "droplet_size": "<string>",
    "boom_height": "<string>",
    "include_soil_analysis": True,
    "include_mitigations": True
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    account_id: '<string>',
    provider_id: '<string>',
    field_name: '<string>',
    application_id: '<string>',
    application_method: '<string>',
    application_date: '<string>',
    field_boundary: {},
    products: [{}],
    crop: [{}],
    pest: [{}],
    provider_field_id: '<string>',
    user_email: '<string>',
    gpa: 123,
    include_geometry: true,
    buffer_distance_miles: 123,
    droplet_size: '<string>',
    boom_height: '<string>',
    include_soil_analysis: true,
    include_mitigations: true
  })
};

fetch('https://esa.acreblitz.com/api/v1/esa-check', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://esa.acreblitz.com/api/v1/esa-check",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'account_id' => '<string>',
    'provider_id' => '<string>',
    'field_name' => '<string>',
    'application_id' => '<string>',
    'application_method' => '<string>',
    'application_date' => '<string>',
    'field_boundary' => [
        
    ],
    'products' => [
        [
                
        ]
    ],
    'crop' => [
        [
                
        ]
    ],
    'pest' => [
        [
                
        ]
    ],
    'provider_field_id' => '<string>',
    'user_email' => '<string>',
    'gpa' => 123,
    'include_geometry' => true,
    'buffer_distance_miles' => 123,
    'droplet_size' => '<string>',
    'boom_height' => '<string>',
    'include_soil_analysis' => true,
    'include_mitigations' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://esa.acreblitz.com/api/v1/esa-check"

	payload := strings.NewReader("{\n  \"account_id\": \"<string>\",\n  \"provider_id\": \"<string>\",\n  \"field_name\": \"<string>\",\n  \"application_id\": \"<string>\",\n  \"application_method\": \"<string>\",\n  \"application_date\": \"<string>\",\n  \"field_boundary\": {},\n  \"products\": [\n    {}\n  ],\n  \"crop\": [\n    {}\n  ],\n  \"pest\": [\n    {}\n  ],\n  \"provider_field_id\": \"<string>\",\n  \"user_email\": \"<string>\",\n  \"gpa\": 123,\n  \"include_geometry\": true,\n  \"buffer_distance_miles\": 123,\n  \"droplet_size\": \"<string>\",\n  \"boom_height\": \"<string>\",\n  \"include_soil_analysis\": true,\n  \"include_mitigations\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://esa.acreblitz.com/api/v1/esa-check")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"account_id\": \"<string>\",\n  \"provider_id\": \"<string>\",\n  \"field_name\": \"<string>\",\n  \"application_id\": \"<string>\",\n  \"application_method\": \"<string>\",\n  \"application_date\": \"<string>\",\n  \"field_boundary\": {},\n  \"products\": [\n    {}\n  ],\n  \"crop\": [\n    {}\n  ],\n  \"pest\": [\n    {}\n  ],\n  \"provider_field_id\": \"<string>\",\n  \"user_email\": \"<string>\",\n  \"gpa\": 123,\n  \"include_geometry\": true,\n  \"buffer_distance_miles\": 123,\n  \"droplet_size\": \"<string>\",\n  \"boom_height\": \"<string>\",\n  \"include_soil_analysis\": true,\n  \"include_mitigations\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://esa.acreblitz.com/api/v1/esa-check")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"account_id\": \"<string>\",\n  \"provider_id\": \"<string>\",\n  \"field_name\": \"<string>\",\n  \"application_id\": \"<string>\",\n  \"application_method\": \"<string>\",\n  \"application_date\": \"<string>\",\n  \"field_boundary\": {},\n  \"products\": [\n    {}\n  ],\n  \"crop\": [\n    {}\n  ],\n  \"pest\": [\n    {}\n  ],\n  \"provider_field_id\": \"<string>\",\n  \"user_email\": \"<string>\",\n  \"gpa\": 123,\n  \"include_geometry\": true,\n  \"buffer_distance_miles\": 123,\n  \"droplet_size\": \"<string>\",\n  \"boom_height\": \"<string>\",\n  \"include_soil_analysis\": true,\n  \"include_mitigations\": true\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "esa_required": true,
  "account_id": "<string>",
  "provider_id": "<string>",
  "field_id": "<string>",
  "application_event_id": "<string>",
  "mitigations_required": true,
  "mitigation_portal_url": "<string>",
  "expires_at": "<string>",
  "user_email": "<string>",
  "products": [
    {}
  ],
  "summary": {}
}

POST

api

esa-check

ESA Check

curl --request POST \
  --url https://esa.acreblitz.com/api/v1/esa-check \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "account_id": "<string>",
  "provider_id": "<string>",
  "field_name": "<string>",
  "application_id": "<string>",
  "application_method": "<string>",
  "application_date": "<string>",
  "field_boundary": {},
  "products": [
    {}
  ],
  "crop": [
    {}
  ],
  "pest": [
    {}
  ],
  "provider_field_id": "<string>",
  "user_email": "<string>",
  "gpa": 123,
  "include_geometry": true,
  "buffer_distance_miles": 123,
  "droplet_size": "<string>",
  "boom_height": "<string>",
  "include_soil_analysis": true,
  "include_mitigations": true
}
'

import requests

url = "https://esa.acreblitz.com/api/v1/esa-check"

payload = {
    "account_id": "<string>",
    "provider_id": "<string>",
    "field_name": "<string>",
    "application_id": "<string>",
    "application_method": "<string>",
    "application_date": "<string>",
    "field_boundary": {},
    "products": [{}],
    "crop": [{}],
    "pest": [{}],
    "provider_field_id": "<string>",
    "user_email": "<string>",
    "gpa": 123,
    "include_geometry": True,
    "buffer_distance_miles": 123,
    "droplet_size": "<string>",
    "boom_height": "<string>",
    "include_soil_analysis": True,
    "include_mitigations": True
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    account_id: '<string>',
    provider_id: '<string>',
    field_name: '<string>',
    application_id: '<string>',
    application_method: '<string>',
    application_date: '<string>',
    field_boundary: {},
    products: [{}],
    crop: [{}],
    pest: [{}],
    provider_field_id: '<string>',
    user_email: '<string>',
    gpa: 123,
    include_geometry: true,
    buffer_distance_miles: 123,
    droplet_size: '<string>',
    boom_height: '<string>',
    include_soil_analysis: true,
    include_mitigations: true
  })
};

fetch('https://esa.acreblitz.com/api/v1/esa-check', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://esa.acreblitz.com/api/v1/esa-check",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'account_id' => '<string>',
    'provider_id' => '<string>',
    'field_name' => '<string>',
    'application_id' => '<string>',
    'application_method' => '<string>',
    'application_date' => '<string>',
    'field_boundary' => [
        
    ],
    'products' => [
        [
                
        ]
    ],
    'crop' => [
        [
                
        ]
    ],
    'pest' => [
        [
                
        ]
    ],
    'provider_field_id' => '<string>',
    'user_email' => '<string>',
    'gpa' => 123,
    'include_geometry' => true,
    'buffer_distance_miles' => 123,
    'droplet_size' => '<string>',
    'boom_height' => '<string>',
    'include_soil_analysis' => true,
    'include_mitigations' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://esa.acreblitz.com/api/v1/esa-check"

	payload := strings.NewReader("{\n  \"account_id\": \"<string>\",\n  \"provider_id\": \"<string>\",\n  \"field_name\": \"<string>\",\n  \"application_id\": \"<string>\",\n  \"application_method\": \"<string>\",\n  \"application_date\": \"<string>\",\n  \"field_boundary\": {},\n  \"products\": [\n    {}\n  ],\n  \"crop\": [\n    {}\n  ],\n  \"pest\": [\n    {}\n  ],\n  \"provider_field_id\": \"<string>\",\n  \"user_email\": \"<string>\",\n  \"gpa\": 123,\n  \"include_geometry\": true,\n  \"buffer_distance_miles\": 123,\n  \"droplet_size\": \"<string>\",\n  \"boom_height\": \"<string>\",\n  \"include_soil_analysis\": true,\n  \"include_mitigations\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://esa.acreblitz.com/api/v1/esa-check")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"account_id\": \"<string>\",\n  \"provider_id\": \"<string>\",\n  \"field_name\": \"<string>\",\n  \"application_id\": \"<string>\",\n  \"application_method\": \"<string>\",\n  \"application_date\": \"<string>\",\n  \"field_boundary\": {},\n  \"products\": [\n    {}\n  ],\n  \"crop\": [\n    {}\n  ],\n  \"pest\": [\n    {}\n  ],\n  \"provider_field_id\": \"<string>\",\n  \"user_email\": \"<string>\",\n  \"gpa\": 123,\n  \"include_geometry\": true,\n  \"buffer_distance_miles\": 123,\n  \"droplet_size\": \"<string>\",\n  \"boom_height\": \"<string>\",\n  \"include_soil_analysis\": true,\n  \"include_mitigations\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://esa.acreblitz.com/api/v1/esa-check")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"account_id\": \"<string>\",\n  \"provider_id\": \"<string>\",\n  \"field_name\": \"<string>\",\n  \"application_id\": \"<string>\",\n  \"application_method\": \"<string>\",\n  \"application_date\": \"<string>\",\n  \"field_boundary\": {},\n  \"products\": [\n    {}\n  ],\n  \"crop\": [\n    {}\n  ],\n  \"pest\": [\n    {}\n  ],\n  \"provider_field_id\": \"<string>\",\n  \"user_email\": \"<string>\",\n  \"gpa\": 123,\n  \"include_geometry\": true,\n  \"buffer_distance_miles\": 123,\n  \"droplet_size\": \"<string>\",\n  \"boom_height\": \"<string>\",\n  \"include_soil_analysis\": true,\n  \"include_mitigations\": true\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "esa_required": true,
  "account_id": "<string>",
  "provider_id": "<string>",
  "field_id": "<string>",
  "application_event_id": "<string>",
  "mitigations_required": true,
  "mitigation_portal_url": "<string>",
  "expires_at": "<string>",
  "user_email": "<string>",
  "products": [
    {}
  ],
  "summary": {}
}

Check if a field has active Pesticide Use Limitation Areas (PULAs) for the products in your tank mix. Returns detailed limitation data and a white-labeled portal URL for mitigation selection.

Request Body

Required Fields

account_id

string

required

Your customer account identifier. Controls portal access and is displayed in reports.

provider_id

string

required

Your internal provider identifier, assigned by AcreBlitz.

field_name

string

required

Name of the field. Displayed in the portal and on compliance reports.

application_id

string

required

Unique identifier for the application job in your system. Used for idempotency — resubmit with the same application_id to update results rather than create duplicates.

application_method

string

required

Method of application. Use your own terminology (e.g., "Drone", "Ground Boom", "Airblast", "Helicopter") — we automatically map to the correct regulatory categories (aerial, ground, airblast).

application_date

string

required

Application date in ISO 8601 format (YYYY-MM-DD). Used for temporal validation of PULA restrictions.

field_boundary

object

required

GeoJSON Feature with Polygon or MultiPolygon geometry in EPSG:4326 (WGS84).

Example

{
  "type": "Feature",
  "geometry": {
    "type": "Polygon",
    "coordinates": [[
      [-95.284265, 42.263233],
      [-95.284470, 42.254180],
      [-95.267536, 42.254063],
      [-95.267341, 42.263116],
      [-95.284265, 42.263233]
    ]]
  }
}

products

array

required

Products to check. Each product object contains:

Field	Type	Required	Description
`epa_number`	string	No	EPA registration number (nullable for adjuvants)
`product_name`	string	Yes	Product name
`rate`	number	Yes	Application rate
`rate_unit`	string	Yes	Rate unit (e.g., `"fl oz/acre"`)

Example

[
  {
    "epa_number": "62719-442",
    "product_name": "INTREPID 2F",
    "rate": 16.0,
    "rate_unit": "fl oz/acre"
  }
]

crop

array

required

Crop names being treated (e.g., ["corn", "soybeans"]).

pest

array

required

Target pest names (e.g., ["aphids", "corn borer"]).

Optional Fields

provider_field_id

string

Your internal field identifier. Used as the key for report download endpoints. If omitted, application_id is used as fallback.

user_email

string

End user email address. Stored for your records.

gpa

number

Gallons per acre. Used for mitigation calculations.

include_geometry

boolean

default:"false"

Include buffered PULA geometries in the response. Useful for rendering PULA boundaries on a map.

buffer_distance_miles

number

default:"1.0"

Buffer distance around the field for PULA geometry inclusion (max 10 miles). Only applies when include_geometry is true.

droplet_size

string

Droplet size category (e.g., "medium", "coarse", "very_coarse").

boom_height

string

Boom height for ground applications ("low" or "high").

Reserved Fields (Coming Soon)

include_soil_analysis

boolean

default:"false"

Include soil analysis data in the response. Not yet implemented — currently ignored.

include_mitigations

boolean

default:"false"

Include mitigation options in the response. Not yet implemented — currently ignored.

Response

success

boolean

required

Whether the ESA check completed successfully.

esa_required

boolean

required

Whether any product in the request has ESA label language. If false, no further action is needed.

account_id

string

required

The account ID from your request.

provider_id

string

required

The provider ID from your request.

field_id

string

Internal AcreBlitz field UUID. Only present when esa_required is true.

application_event_id

string

Internal AcreBlitz application event UUID. Only present when esa_required is true.

mitigations_required

boolean

Whether the user must select mitigation practices. Only present when esa_required is true.

mitigation_portal_url

string

Secure URL to the white-labeled mitigation portal. Valid for 1 year. Only present when esa_required is true.

expires_at

string

ISO 8601 timestamp for when the portal link expires. Only present when esa_required is true.

user_email

string

The user email from your request, if provided.

products

array

required

Array of product results. Each product contains:

Field	Type	Description
`epa_number`	string	EPA registration number
`product_name`	string	Product name
`product_status`	string \| null	Registration status (`"Active"`, `"Inactive"`, or `null` if not found)
`esa_required`	boolean \| null	Whether this specific product has ESA label language
`pulas`	array	PULAs affecting this product (empty if no ESA restrictions)

Each PULA in the pulas array contains:

Field	Type	Description
`pula_id`	integer	PULA identifier
`event_name`	string	Regulatory event name (e.g., `"NMFS BiOps 2024"`)
`status`	string	PULA status (e.g., `"effective"`)
`effective_date`	string	Date the PULA became effective
`codes`	string	Limitation codes
`geometry`	object \| null	GeoJSON geometry (only if `include_geometry=true`)
`limitations`	array	Specific limitations for this PULA

Each limitation contains:

Field	Type	Description
`limitation_id`	integer	Limitation identifier
`code`	string	Limitation code (e.g., `"RPMDZ"`)
`limitation`	string	Full limitation text
`mitigation_options`	array	Required mitigation types (e.g., `["epa_runoff"]`)

summary

object

required

Summary statistics for the check.

Field	Type	Description
`total_pulas`	integer	Total PULAs found affecting the field
`total_limitations`	integer	Total limitations across all PULAs
`products_checked`	integer	Number of products checked
`products_with_limitations`	integer	Number of products with active limitations

Examples

ESA Required — Full Response

When one or more products have ESA label language and the field intersects active PULAs:

{
  "success": true,
  "esa_required": true,
  "account_id": "acct-98765",
  "provider_id": "your_provider_id",
  "field_id": "f7a1b2c3-d4e5-6789-abcd-ef0123456789",
  "application_event_id": "a1b2c3d4-e5f6-7890-abcd-ef0123456789",
  "mitigations_required": true,
  "mitigation_portal_url": "https://acreblitz.com/esaportal/field?t=a2a73941e3872bdcd6aae3206060f19db3892aec67bfbef27a2d015b1bf98bc7",
  "expires_at": "2026-06-22T23:59:59Z",
  "user_email": null,
  "products": [
    {
      "epa_number": "62719-442",
      "product_name": "INTREPID 2F",
      "product_status": "Active",
      "esa_required": true,
      "pulas": [
        {
          "pula_id": 95,
          "event_name": "NMFS BiOps 2024",
          "status": "effective",
          "effective_date": "2024-04-30",
          "codes": "RPMDZ",
          "limitations": [
            {
              "limitation_id": 201,
              "code": "RPMDZ",
              "limitation": "Do not apply when soil is saturated...",
              "mitigation_options": ["epa_runoff"]
            }
          ]
        }
      ]
    }
  ],
  "summary": {
    "total_pulas": 1,
    "total_limitations": 1,
    "products_checked": 1,
    "products_with_limitations": 1
  }
}

ESA Not Required — Early Exit

When no products in the tank mix have ESA label language, the API returns early without storing data or creating a portal link:

{
  "success": true,
  "esa_required": false,
  "account_id": "acct-98765",
  "provider_id": "your_provider_id",
  "field_id": null,
  "application_event_id": null,
  "mitigations_required": null,
  "mitigation_portal_url": null,
  "expires_at": null,
  "user_email": null,
  "products": [
    {
      "epa_number": "12345-678",
      "product_name": "GENERIC HERBICIDE",
      "product_status": "Active",
      "esa_required": false,
      "pulas": []
    }
  ],
  "summary": {
    "total_pulas": 0,
    "total_limitations": 0,
    "products_checked": 1,
    "products_with_limitations": 0
  }
}

Notes

Idempotency: The application_id field makes the endpoint idempotent. Resubmitting with the same application_id updates the existing record rather than creating a duplicate. Use this to refresh results when products or application details change.

Provider Field ID Fallback: If you don’t provide provider_field_id, the application_id is used as the field identifier for report download endpoints.

Flexible Application Methods: You can use your own terminology for application_method (e.g., "Drone", "Helicopter", "Ground Boom"). The API automatically maps these to the correct regulatory categories.

GeoJSON Format: The field_boundary must be a GeoJSON Feature with a Polygon or MultiPolygon geometry in EPSG:4326 (WGS84). MultiPolygon is supported for fields with excluded areas or multiple sections.

API Reference Process Field

​Request Body

​Required Fields

​Optional Fields

​Reserved Fields (Coming Soon)

​Response

​Examples

​Notes

Request Body

Required Fields

Optional Fields

Reserved Fields (Coming Soon)

Response

Examples

Notes