> ## 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
> State which API version you are using. V1 uses https://esa.acreblitz.com/api/v1; V2 uses https://esa-v2.acreblitz.com/api/v2.
> Read /llms.txt for links to both versions. For V2 bulk integration, read bulk submission, status, results, and /v2/errors before constructing requests.

# Runoff compliance report

> Download the Runoff compliance report for a provider-owned field

Download the Runoff compliance report for a provider-owned field.

<ParamField path="provider_field_id" type="string" required>
  Your field identifier from the single check, bulk field entry, or field-processing request.
</ParamField>

<ParamField query="year" type="integer">
  Optional report year, 1900–2200.
</ParamField>

## Response

A successful request returns **200** with `Content-Type: application/pdf` and an attachment filename. Save the response bytes as a `.pdf` file.

```http 200 theme={null}
Content-Type: application/pdf
Content-Disposition: attachment; filename=mitigation-report.pdf
```

The field must belong to your provider and have an active, unexpired, unarchived portal. An unknown or unavailable field returns 404; an ambiguous field identifier returns 409. Dependent report failures can return 502. The report uses the field's current saved data; the download request does not rerun the ESA check.

The example requests the 2026 report.

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET 'https://esa-v2.acreblitz.com/api/v2/fields/north-field/reports/runoff?year=2026' \
    --header "X-API-Key: $ACREBLITZ_API_KEY" \
    --output runoff-report.pdf
  ```
</RequestExample>

## Errors

Report errors are `404 FIELD_NOT_FOUND`, `409 DUPLICATE_FIELD`, `502 INVALID_REPORT`, `503 PORTAL_SERVICE_UNCONFIGURED` or `PORTAL_SAS_UNCONFIGURED`, and `PORTAL_REQUEST_FAILED` with HTTP 400, 403, 404, 422, or 502. Error bodies use JSON even though successful responses are PDFs.

All routes can also return [authentication, validation, rate-limit, and dependency errors](/v2/errors#http-error-catalog). Use the [error catalog and examples](/v2/errors) to choose a retry or correction. Keep `X-Request-ID` when present.