> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acreblitz.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Use the V2 API at https://esa.acreblitz.com/api/v2. V1 is deprecated and is no longer documented.
> Read /llms.txt for all supported endpoints. For bulk integration, read bulk submission, status, results, and /v2/errors before constructing requests.

# ESA API V2

> Synchronous ESA assessments, bulk jobs, soil analysis, and portal controls

Use V2 to check one pesticide application or submit a group of fields for asynchronous processing. You receive PULA requirements, runoff and drift assessments, and portal links for review.

Base URL: `https://esa.acreblitz.com`. All API routes use the `/api/v2` prefix.

V1 is deprecated. This documentation covers the supported V2 endpoints.

> [card] [Quickstart](https://docs.acreblitz.com/v2/quickstart.md)
>
> Run a single check and inspect the assessment.

> [card] [Bulk checks](https://docs.acreblitz.com/v2/api-reference/endpoint/bulk-submit.md)
>
> Submit up to 100 fields with shared products and crops.

> [card] [Migrate to V2](https://docs.acreblitz.com/v2/migration.md)
>
> Review request validation and response changes.

> [card] [API reference](https://docs.acreblitz.com/v2/api-reference/introduction.md)
>
> Browse every V2 endpoint.

## Interpret an assessment

Read [Understanding compliance determinations](https://docs.acreblitz.com/v2/compliance-determination.md) for the full runoff and drift workflow, setup violations, status precedence, and when to refresh saved results.

An HTTP 200 response or `success: true` means the request was handled. Read `compliance.status`, `compliance.processing_complete`, and `compliance.issues` before making a decision. A completed calculation can remain `indeterminate` when applicability, weather, or field conditions need review.

| Status | Meaning |
| - | - |
| `met` | Evaluated requirements are met within the assessment's scope. |
| `not_met` | A verified requirement has a shortfall. |
| `not_applicable` | No applicable requirement was established for the verified inputs. |
| `indeterminate` | Evidence, processing, or verification is incomplete. |

An ESA assessment does not grant unrestricted application clearance. Review the product label, returned PULA text, and unresolved conditions.

## Soil reuse and refreshed results

After portal changes, use [get application compliance](https://docs.acreblitz.com/v2/api-reference/endpoint/application-compliance.md) or [get group compliance](https://docs.acreblitz.com/v2/api-reference/endpoint/group-compliance.md) to read current runoff scoring, saved requirements, and full drift details. These read-only endpoints use `Cache-Control: no-store`. Their `last_assessment` is historical; retrieval does not produce a new overall compliance verdict.

V2 reuses soil when the field boundary and processing version match. A changed field boundary triggers fresh processing. Background soil enrichment does not rewrite a returned assessment; resubmit the same application to refresh it. Bulk polling responses use `Cache-Control: no-store`. Do not cache job status as a final assessment.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.