Download the Runoff compliance report for a provider-owned field.
string
required
Your field identifier from the single check, bulk field entry, or field-processing request.
integer
Optional report year, 1900–2200.
string
Optional grower name, up to 200 characters. It prints in the report’s Name field in place of your provider name.
string
Optional farm name, up to 200 characters. It prints before the field name, as Farm / Field.
AcreBlitz does not store grower_name or farm_name. They apply only to the compliance report from that request. Send them on each download where you want them to appear. Blank values are ignored. A value over 200 characters or with control characters returns 422 INVALID_REQUEST. URL-encode both values.
Response
A successful request returns 200 with Content-Type: application/pdf and an attachment filename. Save the response bytes as a .pdf file.
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 labeled with a grower and farm name.
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. Use the error catalog and examples to choose a retry or correction. Keep X-Request-ID when present.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"AcreBlitz API","description":"ESA and PULA API documentation, examples, and error handling for AcreBlitz V2.","colors":{"primary":"#07C983","light":"#07C983","dark":"#0A1628"},"logo":{"light":"https://mintcdn.com/acreblitz/M4CU6UtEcJwvyhMB/logo/acreblitz_logo.png?fit=max\u0026auto=format\u0026n=M4CU6UtEcJwvyhMB\u0026q=85\u0026s=87ff65e955bb072c4dfcb99c385ffe62","dark":"https://mintcdn.com/acreblitz/1sdhJajpjVTszrAh/logo/acre_blitz_darkmode.png?fit=max\u0026auto=format\u0026n=1sdhJajpjVTszrAh\u0026q=85\u0026s=5cdf46bffc37ea34237c81ea54e21846"},"favicon":"https://mintcdn.com/acreblitz/M4CU6UtEcJwvyhMB/favicon.png?fit=max\u0026auto=format\u0026n=M4CU6UtEcJwvyhMB\u0026q=85\u0026s=661cbc2aec076ace0f644c0ab924aac6","api":{"mdx":{"auth":{"method":"key","name":"X-API-Key"},"server":"https://esa.acreblitz.com"}},"navbar":{"links":[{"href":"mailto:support@acreblitz.com","label":"Support"}],"primary":{"type":"button","label":"Get API Key","href":"https://www.acreblitz.com/contact"}},"footer":{"socials":{"website":"https://www.acreblitz.com"}},"contextual":{"options":["copy","chatgpt","claude"],"display":"header"},"markdown":{"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."]},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"acreblitz","hasAudioNarration":false,"actualSubdomain":"acreblitz","customDomains":["docs.acreblitz.com"],"gitSource":{"type":"github","owner":"coreyfransen08","repo":"acreblitz-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6af6581e7182920037c6d66f","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"API Reference","count":17},{"language":"default","tag":"Documentation","count":7},{"language":"default","tag":"Integration guides","count":4},{"language":"default","tag":"Portal and application controls","count":4},{"language":"default","tag":"Field and soil","count":4},{"language":"default","tag":"Bulk checks","count":3},{"language":"default","tag":"Getting started","count":3},{"language":"default","tag":"Compliance information","count":2},{"language":"default","tag":"Compliance reports","count":2},{"language":"default","tag":"ESA checks","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"v2/api-reference/endpoint/runoff-report","slug":"/v2/api-reference/endpoint/runoff-report","pageMetadata":{"title":"Runoff compliance report","description":"Download the Runoff compliance report for a provider-owned field","api":"GET https://esa.acreblitz.com/api/v2/fields/{provider_field_id}/reports/runoff","href":"/v2/api-reference/endpoint/runoff-report"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Download the Runoff compliance report for a provider-owned field\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,ParamField}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Download the Runoff compliance report for a provider-owned field.`}),`\n`,_jsx(ParamField,{path:`provider_field_id`,type:`string`,required:true,id:`param-provider-field-id`,children:_jsx(_components.p,{children:`Your field identifier from the single check, bulk field entry, or field-processing request.`})}),`\n`,_jsx(ParamField,{query:`year`,type:`integer`,id:`param-year`,children:_jsx(_components.p,{children:`Optional report year, 1900–2200.`})}),`\n`,_jsx(ParamField,{query:`grower_name`,type:`string`,id:`param-grower-name`,children:_jsxs(_components.p,{children:[`Optional grower name, up to 200 characters. It prints in the report’s `,_jsx(_components.strong,{children:`Name`}),` field in place of your provider name.`]})}),`\n`,_jsx(ParamField,{query:`farm_name`,type:`string`,id:`param-farm-name`,children:_jsxs(_components.p,{children:[`Optional farm name, up to 200 characters. It prints before the field name, as `,_jsx(_components.code,{children:`Farm / Field`}),`.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`AcreBlitz does not store `,_jsx(_components.code,{children:`grower_name`}),` or `,_jsx(_components.code,{children:`farm_name`}),`. They apply only to the compliance report from that request. Send them on each download where you want them to appear. Blank values are ignored. A value over 200 characters or with control characters returns `,_jsx(_components.code,{children:`422 INVALID_REQUEST`}),`. URL-encode both values.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsxs(_components.p,{children:[`A successful request returns `,_jsx(_components.strong,{children:`200`}),` with `,_jsx(_components.code,{children:`Content-Type: application/pdf`}),` and an attachment filename. Save the response bytes as a `,_jsx(_components.code,{children:`.pdf`}),` file.`]}),`\n`,_jsx(CodeBlock,{filename:`200`,numberOfLines:`2`,language:`http`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Content-Type`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` application/pdf`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Content-Disposition`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` attachment; filename=mitigation-report.pdf`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsx(_components.p,{children:`The example requests the 2026 report labeled with a grower and farm name.`}),`\n`,`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsxs(_components.p,{children:[`Report errors are `,_jsx(_components.code,{children:`404 FIELD_NOT_FOUND`}),`, `,_jsx(_components.code,{children:`409 DUPLICATE_FIELD`}),`, `,_jsx(_components.code,{children:`502 INVALID_REPORT`}),`, `,_jsx(_components.code,{children:`503 PORTAL_SERVICE_UNCONFIGURED`}),` or `,_jsx(_components.code,{children:`PORTAL_SAS_UNCONFIGURED`}),`, and `,_jsx(_components.code,{children:`PORTAL_REQUEST_FAILED`}),` with HTTP 400, 403, 404, 422, or 502. Error bodies use JSON even though successful responses are PDFs.`]}),`\n`,_jsxs(_components.p,{children:[`All routes can also return `,_jsx(_components.a,{href:`/v2/errors#http-error-catalog`,children:`authentication, validation, rate-limit, and dependency errors`}),`. Use the `,_jsx(_components.a,{href:`/v2/errors`,children:`error catalog and examples`}),` to choose a retry or correction. Keep `,_jsx(_components.code,{children:`X-Request-ID`}),` when present.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Runoff compliance report","description":"Download the Runoff compliance report for a provider-owned field","api":"GET https://esa.acreblitz.com/api/v2/fields/{provider_field_id}/reports/runoff","href":"/v2/api-reference/endpoint/runoff-report"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[322,327,",RequestExample}=_co"],[536,553,"if(!RequestExample)_missingMdxReference(`RequestExample`,true);return _jsxs(_Fra"],[3989,3994,"_jsx(RequestExample,{children:_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`7`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --request`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` GET`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://esa.acreblitz.com/api/v2/fields/north-field/reports/runoff'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --get`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'year=2026'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'grower_name=Jane Smith'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'farm_name=North Farm'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-API-Key: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$ACREBLITZ_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --output`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` runoff-report.pdf`})]}),`\n`]})})})}),`\n`,_"]]},"mdxExtracts":{"tableOfContents":[{"title":"Response","slug":"response","depth":2,"children":[]},{"title":"Errors","slug":"errors","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"cURL","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"7\">\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --request\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> GET\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'https://esa.acreblitz.com/api/v2/fields/north-field/reports/runoff'\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --get\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --data-urlencode\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'year=2026'\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --data-urlencode\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'grower_name=Jane Smith'\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --data-urlencode\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'farm_name=North Farm'\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --header\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"X-API-Key: \u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">$ACREBLITZ_API_KEY\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --output\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> runoff-report.pdf\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Runoff compliance report","path":"/api/v2/fields/{provider_field_id}/reports/runoff","servers":[{"url":"https://esa.acreblitz.com"}],"method":"get","request":{"security":[{"title":"API Key Auth","parameters":{"header":{"X-API-Key":{"type":"apiKey"}},"query":{},"cookie":{}}}],"parameters":{"query":{"year":{"schema":[{"type":"integer","description":"Optional report year, 1900–2200."}]},"grower_name":{"schema":[{"type":"string","description":"Optional grower name, up to 200 characters. It prints in the report’s Name field in place of your provider name."}]},"farm_name":{"schema":[{"type":"string","description":"Optional farm name, up to 200 characters. It prints before the field name, as `Farm / Field` ."}]}},"header":{},"cookie":{},"path":{"provider_field_id":{"schema":[{"type":"string","description":"Your field identifier from the single check, bulk field entry, or field-processing request.","required":true}]}}},"body":{}},"response":{},"deprecated":false}},"jsLinks":[],"subdomain":"acreblitz","siteName":"AcreBlitz API","title":"Runoff compliance report - AcreBlitz API","navMaps":{"firstHrefInVersion":{"V2":{"href":"/v2/api-reference/endpoint/runoff-report","matchLevel":0}},"firstHrefInLanguage":{}},"lastModified":"2026-11-13T00:21:53.797Z","originalFileLocation":"v2/api-reference/endpoint/runoff-report.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Download the Runoff compliance report for a provider-owned field\">\u003cmeta data-mint-head name=\"application-name\" content=\"AcreBlitz API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/acreblitz/bPdOhtkLGkUDSLbi/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/acreblitz/bPdOhtkLGkUDSLbi/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/acreblitz/bPdOhtkLGkUDSLbi/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/acreblitz/bPdOhtkLGkUDSLbi/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/acreblitz/bPdOhtkLGkUDSLbi/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/acreblitz/bPdOhtkLGkUDSLbi/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/acreblitz/bPdOhtkLGkUDSLbi/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/acreblitz/bPdOhtkLGkUDSLbi/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/acreblitz/bPdOhtkLGkUDSLbi/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Runoff compliance report - AcreBlitz API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Download the Runoff compliance report for a provider-owned field\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"AcreBlitz API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.acreblitz.com/v2/api-reference/endpoint/runoff-report\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://acreblitz.mintlify.site/_mintlify/api/og/v2?division=Compliance+reports\u0026amp;title=Runoff+compliance+report\u0026amp;description=Download+the+Runoff+compliance+report+for+a+provider-owned+field\u0026amp;theme=08954e11f1034e2c486387d1\u0026amp;signature=79bb51667aac1d9702439a23e85bd03a4fdc2245dde8a302727021c9a91e89b9\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Runoff compliance report - AcreBlitz API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Download the Runoff compliance report for a provider-owned field\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://acreblitz.mintlify.site/_mintlify/api/og/v2?division=Compliance+reports\u0026amp;title=Runoff+compliance+report\u0026amp;description=Download+the+Runoff+compliance+report+for+a+provider-owned+field\u0026amp;theme=08954e11f1034e2c486387d1\u0026amp;signature=79bb51667aac1d9702439a23e85bd03a4fdc2245dde8a302727021c9a91e89b9\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/acreblitz/bPdOhtkLGkUDSLbi/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"AcreBlitz API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#07C983\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.acreblitz.com/v2/api-reference/endpoint/runoff-report\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/v2/api-reference/endpoint/runoff-report.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.acreblitz.com/#organization\",\"name\":\"AcreBlitz API\",\"url\":\"https://docs.acreblitz.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/acreblitz/M4CU6UtEcJwvyhMB/logo/acreblitz_logo.png?fit=max\u0026auto=format\u0026n=M4CU6UtEcJwvyhMB\u0026q=85\u0026s=87ff65e955bb072c4dfcb99c385ffe62\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.acreblitz.com#website\",\"name\":\"AcreBlitz API\",\"url\":\"https://docs.acreblitz.com\",\"publisher\":{\"@id\":\"https://docs.acreblitz.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.acreblitz.com/v2/api-reference/endpoint/runoff-report#webpage\",\"url\":\"https://docs.acreblitz.com/v2/api-reference/endpoint/runoff-report\",\"name\":\"Runoff compliance report\",\"description\":\"Download the Runoff compliance report for a provider-owned field\",\"dateModified\":\"2026-11-13T00:21:53.797Z\",\"isPartOf\":{\"@id\":\"https://docs.acreblitz.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.acreblitz.com/v2/api-reference/endpoint/runoff-report#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.acreblitz.com/v2/api-reference/endpoint/runoff-report#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Compliance reports\",\"item\":\"https://docs.acreblitz.com/v2/api-reference/endpoint/enlist-report\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Runoff compliance report\",\"item\":\"https://docs.acreblitz.com/v2/api-reference/endpoint/runoff-report\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.acreblitz.com/v2/api-reference/endpoint/runoff-report#apireference\",\"headline\":\"Runoff compliance report\",\"name\":\"Runoff compliance report\",\"description\":\"Download the Runoff compliance report for a provider-owned field\",\"url\":\"https://docs.acreblitz.com/v2/api-reference/endpoint/runoff-report\",\"mainEntityOfPage\":{\"@id\":\"https://docs.acreblitz.com/v2/api-reference/endpoint/runoff-report#webpage\"},\"dateModified\":\"2026-11-13T00:21:53.797Z\",\"publisher\":{\"@id\":\"https://docs.acreblitz.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.acreblitz.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"AcreBlitz API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"AcreBlitz API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/v2/api-reference/endpoint/runoff-report.md","siteName":"AcreBlitz API","nav":{"global":null,"versions":[{"version":"V2","default":true,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/v2"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API overview","href":"/v2/api-reference/introduction"}]},{"group":"ESA checks","pages":[{"title":"ESA check","api":"POST https://esa.acreblitz.com/api/v2/esa-check","href":"/v2/api-reference/endpoint/esa-check"}]},{"group":"Bulk checks","pages":[{"title":"Submit bulk checks","api":"POST https://esa.acreblitz.com/api/v2/esa-check/bulk","href":"/v2/api-reference/endpoint/bulk-submit"},{"title":"Get bulk job status","api":"GET https://esa.acreblitz.com/api/v2/esa-check/bulk/{job_id}","href":"/v2/api-reference/endpoint/bulk-status"},{"title":"Get bulk results","api":"GET https://esa.acreblitz.com/api/v2/esa-check/bulk/{job_id}/results","href":"/v2/api-reference/endpoint/bulk-results"}]},{"group":"Field and soil","pages":[{"title":"Analyze soil","api":"POST https://esa.acreblitz.com/api/v2/soil/process","href":"/v2/api-reference/endpoint/soil-process"},{"title":"Runoff baseline","api":"POST https://esa.acreblitz.com/api/v2/field/runoff-baseline","href":"/v2/api-reference/endpoint/runoff-baseline"},{"title":"Process a field","api":"POST https://esa.acreblitz.com/api/v2/process-field","href":"/v2/api-reference/endpoint/process-field"},{"title":"Get runoff mitigation options","api":"GET https://esa.acreblitz.com/api/v2/mitigations/{mitigation_type}","href":"/v2/api-reference/endpoint/mitigations"}]},{"group":"Compliance information","pages":[{"title":"Get application compliance","api":"GET https://esa.acreblitz.com/api/v2/applications/{application_event_id}/compliance","href":"/v2/api-reference/endpoint/application-compliance"},{"title":"Get group compliance","api":"GET https://esa.acreblitz.com/api/v2/groups/{provider_group_id}/compliance","href":"/v2/api-reference/endpoint/group-compliance"}]},{"group":"Compliance reports","pages":[{"title":"Enlist compliance report","description":"Download the Enlist compliance report for a provider-owned field","api":"GET https://esa.acreblitz.com/api/v2/fields/{provider_field_id}/reports/enlist","href":"/v2/api-reference/endpoint/enlist-report"},{"title":"Runoff compliance report","api":"GET https://esa.acreblitz.com/api/v2/fields/{provider_field_id}/reports/runoff","href":"/v2/api-reference/endpoint/runoff-report"}]},{"group":"Portal and application controls","pages":[{"title":"Issue portal access","description":"Issue an expiring portal link for one application","api":"POST https://esa.acreblitz.com/api/v2/applications/{application_event_id}/portal-access","href":"/v2/api-reference/endpoint/portal-access"},{"title":"Set application portal lock","api":"PUT https://esa.acreblitz.com/api/v2/applications/{application_event_id}/portal-lock","href":"/v2/api-reference/endpoint/portal-lock"},{"title":"Set group portal lock","api":"PUT https://esa.acreblitz.com/api/v2/groups/{provider_group_id}/portal-lock","href":"/v2/api-reference/endpoint/group-portal-lock"},{"title":"Compute application-time drift buffers","api":"POST https://esa.acreblitz.com/api/v2/applications/{application_event_id}/drift-buffer/compute","href":"/v2/api-reference/endpoint/drift-buffer"}]}]}]}]},"basePath":"","title":"Runoff compliance report - AcreBlitz API","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-DdEMm2kG.js","utils-BMo572L7.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C-4m9KAx.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DPLK2Oq9.js","snippetPresets-BKjfJMC9.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DTsgtCEj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C8vmhyQM.js","shallow-r9w8LQGS.js","getApiPlaygroundDisplay-DjPI64HQ.js","CodeSnippet-C8Bvhl16.js","CodeSnippets-BtWUwcMy.js","Page-BIYvYBgk.js","getPastedJson-Dcm_3Pgl.js","icon-BXwrTpjc.js","MethodPill-CcjfVmmy.js","DuplicateIcon-BuKIbXAQ.js","createIcon-DaL9yXsO.js","DynamicMarkdown-Co5nikxh.js","SectionHeading-P4UNTsMZ.js","axios-vUo_bRtp.js"]}