Skip to main content
This endpoint provides a real-time snapshot of the AgriBackup API infrastructure and its three critical external dependencies: the Hedera Hashgraph distributed ledger used for cryptographic anchoring, the Copernicus CDSE Sentinel-2 satellite system used for deforestation analysis, and HashiCorp Vault used for credential management. You should integrate this endpoint into your monitoring stack to proactively detect degraded states before they affect your compliance operations. If any dependency is DOWN, the corresponding ingestion or anchoring features will be unavailable or running in a degraded mode. The global status field reflects the worst-case health across all components.

​
Endpoint

GET /api/v1/enterprise/eudr/health

​
Response Fields

​
status
string
required
The global health status of the EUDR API. Reflects the aggregate state of all dependencies. Possible values: OPERATIONAL (all systems healthy), DEGRADED (one or more dependencies partially unavailable), DOWN (critical failure preventing API operation).
​
services
object
required
An object containing the individual health status of each service dependency.
​
services.hedera.status
string
required
The connection status to the Hedera Hashgraph node used for DLT anchoring. UP means anchoring and smart contract operations are available. DOWN means all Hedera-dependent operations (polygon anchoring, shipment linking) will fail. Possible values: UP, DOWN.
​
services.hedera.latencyMs
integer
Network latency to the Hedera consensus node in milliseconds. null if the node is unreachable.
​
services.copernicus.status
string
required
The connection status to Copernicus CDSE Sentinel-2 satellite APIs and OAuth services used for deforestation analysis. UP means satellite NDVI analysis is available. DOWN means satellite analysis will be unavailable and polygon ingestion will be impacted. Possible values: UP, DOWN.
​
services.copernicus.lastSync
string
ISO-8601 timestamp of the last successful Copernicus OAuth token check or data synchronization. Example: 2026-06-19T12:00:00Z
​
services.vault.status
string
required
The connection status to HashiCorp Vault used for secure storage and retrieval of TRACES NT credentials and signing secrets. UP means credential-dependent operations are available. DOWN means TRACES NT submission and credential operations will fail. Possible values: UP, DOWN.

​
Status Values Reference

Global StatusMeaning
OPERATIONALAll service dependencies are UP. Full API functionality is available.
DEGRADEDOne or more dependencies are DOWN but the API is partially functional.
DOWNCritical dependencies are unavailable. Core API operations are not functioning.

​
Error Responses

StatusCodeDescription
401UNAUTHORIZEDMissing or invalid X-API-Key
403FORBIDDENYour API key does not have diagnostics permissions
import agribackup
from agribackup.rest import ApiException

configuration = agribackup.Configuration(host="https://live.agribackup.com/api/v1")
configuration.api_key['ApiKeyAuth'] = 'sk_live_YOUR_API_KEY'

with agribackup.ApiClient(configuration) as api_client:
    api_instance = agribackup.EnterpriseDiagnosticsApi(api_client)
    try:
        health = api_instance.get_health()
        print(f"Global Status: {health.status}")
        print(f"Hedera DLT:    {health.services.hedera.status} "
              f"(latency: {health.services.hedera.latency_ms}ms)")
        print(f"Copernicus:    {health.services.copernicus.status} "
              f"(last sync: {health.services.copernicus.last_sync})")
        print(f"Vault:         {health.services.vault.status}")

        if health.status != "OPERATIONAL":
            print("\nWARNING: One or more dependencies are degraded. "
                  "Compliance operations may be impacted.")
    except ApiException as e:
        print("Exception when calling get_health: %s\n" % e)

import { AgriBackupClient } from '@agribackup/sdk';

const client = new AgriBackupClient({
  apiKey: 'sk_live_YOUR_API_KEY',
  baseUrl: 'https://live.agribackup.com/api/v1'
});

async function checkHealth() {
  try {
    const health = await client.diagnostics.getHealth();
    console.log(`Global Status: ${health.status}`);
    console.log(`Hedera DLT:    ${health.services.hedera.status} (latency: ${health.services.hedera.latencyMs}ms)`);
    console.log(`Copernicus:    ${health.services.copernicus.status} (last sync: ${health.services.copernicus.lastSync})`);
    console.log(`Vault:         ${health.services.vault.status}`);

    if (health.status !== 'OPERATIONAL') {
      console.warn('WARNING: One or more dependencies are degraded. Compliance operations may be impacted.');
    }
  } catch (error) {
    console.error('Error checking health:', error);
  }
}

checkHealth();

curl --request GET \
  --url https://live.agribackup.com/api/v1/enterprise/eudr/health \
  --header 'X-API-Key: sk_live_YOUR_API_KEY'

​
Example Response (All Systems Operational)

{
  "status": "OPERATIONAL",
  "services": {
    "hedera": {
      "status": "UP",
      "latencyMs": 142
    },
    "copernicus": {
      "status": "UP",
      "lastSync": "2026-06-19T12:00:00Z"
    },
    "vault": {
      "status": "UP"
    }
  }
}

​
Example Response (Degraded — Copernicus Unavailable)

{
  "status": "DEGRADED",
  "services": {
    "hedera": {
      "status": "UP",
      "latencyMs": 155
    },
    "copernicus": {
      "status": "DOWN",
      "lastSync": "2026-06-19T10:00:00Z"
    },
    "vault": {
      "status": "UP"
    }
  }
}
Integrate this endpoint into your ERP health dashboard and set up alerts for any status value other than OPERATIONAL. When copernicus.status is DOWN, polygon ingestion jobs will be unable to complete satellite analysis. When hedera.status is DOWN, anchoring and shipment linking operations will not succeed.