Quickstart

Make your first ESA check in minutes

Prerequisites

Before you begin, you’ll need:

1. An API key — Contact [e-mail] or visit acreblitz.com/contact to get one
2. A GeoJSON field boundary — Polygon or MultiPolygon in EPSG:4326 (WGS84)
3. Product EPA numbers — Registration numbers for products in the tank mix

Step 1: Set Your Auth Header

All requests require the X-API-Key header:

Step 2: Make Your First ESA Check

Send a POST request to the /api/v1/esa-check endpoint with your application data.

cURL

curl -X POST https://esa.acreblitz.com/api/v1/esa-check \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key_here" \
  -d '{
    "account_id": "acct-98765",
    "provider_id": "your_provider_id",
    "field_name": "South Field 25",
    "application_id": "job-2024-06-15-002",
    "provider_field_id": "field-south-25",
    "application_method": "ground",
    "application_date": "2024-06-15",
    "field_boundary": {
      "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": [
      {
        "epa_number": "62719-442",
        "product_name": "INTREPID 2F",
        "rate": 16.0,
        "rate_unit": "fl oz/acre"
      }
    ],
    "crop": ["corn"],
    "pest": ["corn borer"],
    "gpa": 10
  }'

Step 3: Handle the Response

The response tells you whether ESA compliance is required and provides a portal URL if it is.

Example Response — ESA Required

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

Step 4: Direct Users to the Portal

When mitigations_required is true, direct your user to the mitigation_portal_url. You can:

• Embed the link in your application UI
• Send it via email to the applicator or grower
• Open it in a new tab from your platform

The portal URL is valid for 1 year and provides a fully branded experience where your user can:

• View detailed PULA information and field maps
• Select required mitigation practices
• Review soil and weather data
• Download branded compliance reports

Step 5: Download Reports (Optional)

After an ESA check, you can programmatically download compliance reports:

Download Enlist Report

curl -X GET "https://esa.acreblitz.com/api/v1/fields/field-south-25/reports/enlist" \
  -H "X-API-Key: your_api_key_here" \
  -o enlist-report.pdf

Download Runoff Report

curl -X GET "https://esa.acreblitz.com/api/v1/fields/field-south-25/reports/runoff" \
  -H "X-API-Key: your_api_key_here" \
  -o runoff-report.pdf

The provider_field_id in the report URL is the provider_field_id you submitted to /esa-check. If you didn’t provide one, it defaults to the application_id.

Next Steps

ESA Check Reference

Full endpoint reference with all parameters and response fields

Report Endpoints

Programmatic report download reference