Batches
Get EUDR Batch by ID | AgriBackup API Reference
Fetch full details for a single EUDR batch including consolidated risk state, linked polygon IDs, and shipment reference IDs.
GET
Python
Returns the full detail record for a single EUDR batch, including its consolidated Copernicus risk state, lifecycle status, all linked polygon IDs, and any shipment reference IDs assigned via the Logistics endpoints. Use this endpoint to confirm a batch is
COMPLIANT and ready for shipment linking, or to retrieve shipment associations for audit purposes.
Request Headers
| Header | Required | Description |
|---|---|---|
X-API-Key | ✅ | Your live API key, e.g. sk_live_.... |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
batchId | string | ✅ | The unique batch identifier (UUID) returned when the batch was registered. |
Response — 200 OK
| Field | Type | Description |
|---|---|---|
batchId | string | Unique internal batch identifier (UUID). |
batchCode | string | Human-readable compliance code, e.g. COFFEE-KEN-20260612-ABCDEF. |
consolidatedRiskState | string | Aggregate risk state: PENDING_RISK_ASSESSMENT, NONE, LOW, MEDIUM, or HIGH. |
status | string | Batch lifecycle status (e.g. CREATED). |
polygonIds | array of strings | IDs of all farm polygons contributing to this batch. |
shipmentIds | array of strings | Shipment reference IDs linked to this batch via the Logistics API. |
Error Responses
| Status | Meaning |
|---|---|
403 | Your API key does not have permission to access this batch. |
404 | No batch found with the given batchId. |
Code Examples
Authorizations
Enterprise API Key provided via the AgriBackup developer console.
Path Parameters
Response
Batch details retrieved successfully
Detailed view of a single EUDR batch
Internal database ID of the batch
Example:
"uuid-1234"
Unique compliance code for this batch
Example:
"COFFEE-KEN-20260612-ABCDEF"
Consolidated deterministic risk state
Available options:
PENDING_RISK_ASSESSMENT, NONE, LOW, MEDIUM, HIGH Example:
"COMPLIANT"
Batch lifecycle status
Example:
"CREATED"
Linked shipment reference IDs
Linked shipment reference IDs
Polygon IDs contributing to this batch
Polygon IDs contributing to this batch
List EUDR Batches | AgriBackup API Reference
Previous
Update an EUDR Batch | AgriBackup API Reference
Next