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": {}
}

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

string

required

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

string

required

Your internal provider identifier, assigned by AcreBlitz.

string

required

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

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.

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).

string

required

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

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]
    ]]
  }
}

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"
  }
]

array

required

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

array

required

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

Optional Fields

string

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

string

End user email address. Stored for your records.

number

Gallons per acre. Used for mitigation calculations.

boolean

default:"false"

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

number

default:"1.0"

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

string

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

string

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

Reserved Fields (Coming Soon)

boolean

default:"false"

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

boolean

default:"false"

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

Response

boolean

required

Whether the ESA check completed successfully.

boolean

required

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

string

required

The account ID from your request.

string

required

The provider ID from your request.

string

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

string

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

boolean

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

string

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

string

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

string

The user email from your request, if provided.

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"]`)

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.

Overview

Field Processing

Reports

ESA Check

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

Request Body

Required Fields

Optional Fields

Reserved Fields (Coming Soon)

Response

Examples

Notes