Quickstart

curl --request POST 'https://esa.acreblitz.com/api/v2/esa-check' \
  --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",
  "provider_group_id": "work-order-42",
  "field_name": "North field",
  "application_id": "north-application-2026-10-05",
  "application_method": "Broadcast-Ground",
  "application_date": "2026-10-05",
  "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
          ]
        ]
      ]
    }
  },
  "products": [
    {
      "epa_number": "7969-500",
      "product_name": "Liberty Ultra",
      "rate": 32,
      "rate_unit": "fl oz/ac",
      "rate_unit_state": "L"
    }
  ],
  "crop": [
    "Corn"
  ],
  "pest": [
    "Waterhemp"
  ],
  "gpa": 15,
  "droplet_size": "VC",
  "boom_height": "low",
  "include_soil_analysis": true,
  "include_mitigations": true
}'

{
  "success": true,
  "esa_required": true,
  "application_event_id": "019953f8-8c00-7000-8000-000000000002",
  "products": [
    {
      "epa_number": "7969-500",
      "product_name": "Liberty Ultra",
      "pest": ["Waterhemp"],
      "product_status": "Active",
      "esa_required": true,
      "pulas": [
        {
          "pula_id": 12345,
          "event_name": "Example PULA",
          "status": "effective",
          "effective_date": "2026-01-01",
          "codes": "EX1",
          "limitations": [
            {
              "limitation_id": 67890,
              "code": "EX1",
              "limitation": "Illustrative limitation text. Read the returned text for the actual restriction.",
              "mitigation_options": []
            }
          ]
        }
      ]
    }
  ],
  "summary": { "total_pulas": 1, "total_limitations": 1, "products_checked": 1, "products_with_limitations": 1 },
  "compliance": {
    "status": "indeterminate",
    "processing_complete": true,
    "issues": [
      { "code": "LIMITATIONS_REVIEW_REQUIRED", "message": "Review the returned PULA text for conditions not evaluated automatically" },
      { "code": "DRIFT_CONDITIONS_UNVERIFIED", "message": "Buffer placement and application weather have not been verified" }
    ]
  }
}

curl --request POST 'https://esa.acreblitz.com/api/v2/esa-check' \
  --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",
  "provider_group_id": "work-order-42",
  "field_name": "North field",
  "application_id": "north-application-2026-10-05",
  "application_method": "Broadcast-Ground",
  "application_date": "2026-10-05",
  "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
          ]
        ]
      ]
    }
  },
  "products": [
    {
      "epa_number": "7969-500",
      "product_name": "Liberty Ultra",
      "rate": 32,
      "rate_unit": "fl oz/ac",
      "rate_unit_state": "L"
    }
  ],
  "crop": [
    "Corn"
  ],
  "pest": [
    "Waterhemp"
  ],
  "gpa": 15,
  "droplet_size": "VC",
  "boom_height": "low",
  "include_soil_analysis": true,
  "include_mitigations": true
}'

{
  "success": true,
  "esa_required": true,
  "application_event_id": "019953f8-8c00-7000-8000-000000000002",
  "products": [
    {
      "epa_number": "7969-500",
      "product_name": "Liberty Ultra",
      "pest": ["Waterhemp"],
      "product_status": "Active",
      "esa_required": true,
      "pulas": [
        {
          "pula_id": 12345,
          "event_name": "Example PULA",
          "status": "effective",
          "effective_date": "2026-01-01",
          "codes": "EX1",
          "limitations": [
            {
              "limitation_id": 67890,
              "code": "EX1",
              "limitation": "Illustrative limitation text. Read the returned text for the actual restriction.",
              "mitigation_options": []
            }
          ]
        }
      ]
    }
  ],
  "summary": { "total_pulas": 1, "total_limitations": 1, "products_checked": 1, "products_with_limitations": 1 },
  "compliance": {
    "status": "indeterminate",
    "processing_complete": true,
    "issues": [
      { "code": "LIMITATIONS_REVIEW_REQUIRED", "message": "Review the returned PULA text for conditions not evaluated automatically" },
      { "code": "DRIFT_CONDITIONS_UNVERIFIED", "message": "Buffer placement and application weather have not been verified" }
    ]
  }
}

Send one application

Set ACREBLITZ_API_KEY on your backend, replace the provider/account/field identifiers, and submit a valid field boundary. This example uses Liberty Ultra with Broadcast-Ground.

curl --request POST 'https://esa.acreblitz.com/api/v2/esa-check' \
  --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",
  "provider_group_id": "work-order-42",
  "field_name": "North field",
  "application_id": "north-application-2026-10-05",
  "application_method": "Broadcast-Ground",
  "application_date": "2026-10-05",
  "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
          ]
        ]
      ]
    }
  },
  "products": [
    {
      "epa_number": "7969-500",
      "product_name": "Liberty Ultra",
      "rate": 32,
      "rate_unit": "fl oz/ac",
      "rate_unit_state": "L"
    }
  ],
  "crop": [
    "Corn"
  ],
  "pest": [
    "Waterhemp"
  ],
  "gpa": 15,
  "droplet_size": "VC",
  "boom_height": "low",
  "include_soil_analysis": true,
  "include_mitigations": true
}'

Inspect the result

Read compliance.status, processing_complete, and issues. A successful request can have unresolved compliance. Keep the returned application_event_id as an opaque reference for application-time checks and portal controls. Open mitigation_portal_url when one is returned; use the entire URL unchanged. Each entry in products[] lists the PULAs on the field that limit that product for your application method. Show each limitations[].limitation text to the applicator. The API cannot evaluate every condition in that text, so a returned limitation adds LIMITATIONS_REVIEW_REQUIRED and keeps the status indeterminate until reviewed. See product PULA limitations.

{
  "success": true,
  "esa_required": true,
  "application_event_id": "019953f8-8c00-7000-8000-000000000002",
  "products": [
    {
      "epa_number": "7969-500",
      "product_name": "Liberty Ultra",
      "pest": ["Waterhemp"],
      "product_status": "Active",
      "esa_required": true,
      "pulas": [
        {
          "pula_id": 12345,
          "event_name": "Example PULA",
          "status": "effective",
          "effective_date": "2026-01-01",
          "codes": "EX1",
          "limitations": [
            {
              "limitation_id": 67890,
              "code": "EX1",
              "limitation": "Illustrative limitation text. Read the returned text for the actual restriction.",
              "mitigation_options": []
            }
          ]
        }
      ]
    }
  ],
  "summary": { "total_pulas": 1, "total_limitations": 1, "products_checked": 1, "products_with_limitations": 1 },
  "compliance": {
    "status": "indeterminate",
    "processing_complete": true,
    "issues": [
      { "code": "LIMITATIONS_REVIEW_REQUIRED", "message": "Review the returned PULA text for conditions not evaluated automatically" },
      { "code": "DRIFT_CONDITIONS_UNVERIFIED", "message": "Buffer placement and application weather have not been verified" }
    ]
  }
}

If esa_required is false, inspect the issues before treating the result as not applicable. Unknown products can produce an indeterminate assessment. The no-ESA early return does not create or update a saved field/application.

Check multiple fields

Use Submit bulk checks to define common products, crops, pests, method, and date once. Each field can replace those settings independently. A bulk submission requires provider_group_id and returns 202 Accepted with a job_id. The API checks unique products across the full request first. When all are confirmed to have no ESA requirement, it returns status: "completed", esa_required: false, and all items immediately. Otherwise, poll the returned status_url, then page through results_url. These URLs are relative to https://esa.acreblitz.com. Preserve your Idempotency-Key when retrying the same submission. A succeeded bulk item means its check returned a result. Inspect that result’s compliance, even when the overall job is completed.

Continue the workflow

Download compliance reports using your provider_field_id.
Issue a portal link for one application.
Lock portal changes when your review is complete.
Compute application-time drift buffers with current weather inputs.

Getting started

Integration guides

Send one application

Inspect the result

Check multiple fields

Continue the workflow

​Send one application

​Inspect the result

​Check multiple fields

​Continue the workflow

Send one application

Inspect the result

Check multiple fields

Continue the workflow