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

# AgriBackup: Enterprise REST API for EUDR Compliance

> AgriBackup automates EU Deforestation Regulation compliance—satellite polygon verification, Hedera DLT anchoring, and TRACES NT filing in one API.

AgriBackup is the enterprise REST API for EU Deforestation Regulation (EUDR) compliance. It connects your ERP to satellite deforestation screening via Copernicus CDSE, immutable batch anchoring on the Hedera distributed ledger, and automated Due Diligence Statement (DDS) filing to TRACES NT — turning a multi-week manual process into a single programmatic workflow.

## What problems does AgriBackup solve?

The EUDR requires commodity importers to prove that every shipment entering the EU is free from deforestation and produced in compliance with local land-use law. Meeting that requirement involves three hard problems:

* **Geospatial verification.** You must submit precise farm boundaries as GeoJSON polygons and have them screened against up-to-date satellite deforestation datasets. AgriBackup's ingestion pipeline handles batch uploads of up to 5,000 features per request and returns a Copernicus-backed risk verdict.
* **Immutable audit trail.** Each compliant batch must be permanently recorded so that customs authorities and auditors can independently verify it. AgriBackup anchors every batch, polygon, and shipment linkage on the Hedera Hashgraph, producing tamper-proof Merkle state proofs.
* **Automated DDS filing.** Importers must file a DDS with the EU's TRACES NT system before each shipment clears customs. AgriBackup generates the required XML payload, attaches land tenure document hashes anchored on Hedera, and submits directly to TRACES NT on your behalf.

## Key capabilities

| Capability                                        | Endpoint group            |
| ------------------------------------------------- | ------------------------- |
| GeoJSON polygon ingestion & satellite screening   | `Enterprise Polygons`     |
| Consolidated batch registration & risk assessment | `Enterprise Batches`      |
| Hedera smart-contract shipment linking            | `Enterprise Logistics`    |
| DDS generation and TRACES NT submission           | `Enterprise Declarations` |
| Cryptographic evidence retrieval                  | `Enterprise Evidence`     |
| Asynchronous job tracking                         | `Enterprise Jobs`         |
| Bulk archival for auditors                        | `Enterprise Archival`     |

## Get started

<CardGroup cols={2}>
  <Card title="Quickstart" icon="bolt" href="/quickstart">
    Complete the five-step compliance lifecycle end-to-end in under ten minutes.
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    Obtain your API key, understand sandbox vs production, and configure your SDK.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference">
    Full reference for every endpoint, request schema, and response model.
  </Card>

  <Card title="EUDR Compliance" icon="leaf" href="/concepts/eudr-compliance">
    Understand the regulation and how AgriBackup addresses each requirement.
  </Card>
</CardGroup>

## SDK support

AgriBackup ships official SDKs for the three most common enterprise server runtimes:

<CardGroup cols={3}>
  <Card title="Python" icon="python">
    `pip install agribackup-sdk`
  </Card>

  <Card title="Node.js" icon="node-js">
    `npm install @agribackup/sdk`
  </Card>

  <Card title="Java" icon="java">
    Maven artifact `com.agribackup:agribackup-sdk:1.0.0`
  </Card>
</CardGroup>

All SDKs share the same object model, automatically resolve the correct base URL from your API key prefix, and handle request signing, retries, and idempotency transparently.

## Environments

AgriBackup provides two fully isolated environments:

<Tabs>
  <Tab title="Sandbox">
    Use the sandbox to develop and test your integration without affecting live compliance records or interacting with the real Hedera mainnet or TRACES NT.

    * **Base URL:** `https://sandbox.agribackup.com`
    * **API key prefix:** `sk_test_`
    * Satellite screening returns deterministic mock verdicts.
    * Hedera anchoring targets the Hedera testnet.
    * TRACES NT submissions are intercepted and never forwarded to the live EU system.
  </Tab>

  <Tab title="Production">
    The production environment processes real shipments, anchors on Hedera mainnet, and files DDS records with the live TRACES NT system.

    * **Base URL:** `https://live.agribackup.com`
    * **API key prefix:** `sk_live_`
    * Rate limit: **100 requests per second**.
    * All Hedera transactions incur mainnet consensus fees.
  </Tab>
</Tabs>

<Note>
  When you use an official AgriBackup SDK, you do **not** need to specify a base URL. The SDK infers the correct environment automatically from the `sk_live_` or `sk_test_` prefix of your API key.
</Note>

## API conventions

* All endpoints accept and return **JSON** (except multipart document uploads).
* Asynchronous operations return **`202 Accepted`** with a `Location` header pointing to the job status endpoint. Read the [Async Architecture](/concepts/async-architecture) guide to understand the job and webhook model.
* Every response includes `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `X-RateLimit-Reset` headers so you can track your quota in real time.
* Pass an `Idempotency-Key` header on any mutating request to safely retry without creating duplicate records.