Agrovisio Data API

Who this is for

Insurers and insurtech

Before/after damage assessment with a defensible confidence interval, SAR change events as beta signals (detection thresholds are still being calibrated), deterministic PDF certificates and parametric index definitions with backtests.

Banks and lenders

Explainable 0-100 risk scores with six components, portfolio summaries, yield forecasts with intervals and CAP subsidy calculations for borrower income.

Agri-input and agritech

NDVI / NDWI / EVI series with five season baselines, weather history from 1981, thermal water stress and radar events for any parcel in the served countries.

Built for integration

OpenAPI 3.1 that declares every error response, one error envelope with 34 stable types, cursor pagination, idempotent POSTs, signed webhooks, generated Python and TypeScript SDKs, a Postman collection.

The fifteen minute path

1. Get a sandbox key. Register in the client portal and copy the sk_test_... key. No sales call, no card. The sandbox is free, never billed and holds 20 real Lithuanian parcels with five years of Sentinel-1, Sentinel-2 and Sentinel-3 history, so the first call returns a full answer.

   Register for a sandbox key

   In a development environment the demo key printed by the sandbox seed script works straight away; the one below is the key this site was verified with, and the parcels behind it are rebuilt every night.

2. Set three shell variables. Every example on this site uses them.

   Terminal

   export BASE=https://api.staging.agrovisio.ai/v1
   export KEY=sk_test_16e7fa3b7095c7f52f094bec33b48413
   export AUTH="Authorization: Bearer $KEY"

3. Run the three calls below. Each one is complete and works against the sandbox as written. Any UUID works as an Idempotency-Key; python is only used to pull an id out of the JSON.

Parcels

# 1. The 20 shared sandbox parcels (5 years of Sentinel history each)
curl -s "$BASE/parcels?limit=25" -H "$AUTH"

Every parcel carries external_ref, area_ha, crop_hint, environment: "test", a shared flag (true when the parcel belongs to another account than your key’s - the SBX-* set for any sandbox key except the demo account that owns it) and a data_status block that says how much history it already has. Pagination is cursor based: pass next_cursor back as ?cursor= until has_more is false.

NDVI series

# 2. NDVI time series with per-observation anomaly and a five season baseline
export PARCEL=$(curl -s "$BASE/parcels?limit=25" -H "$AUTH" \
  | python -c "import sys,json;d=json.load(sys.stdin)['data'];print([p['parcel_id'] for p in d if p['external_ref']=='SBX-FIELD-01'][0])")

curl -s "$BASE/parcels/$PARCEL/indices?index=NDVI&from=2025-04-01&to=2025-09-30" -H "$AUTH"

A value: null with a reason is an answer, not an error: clouded pixels are never interpolated. anomaly compares each observation with the same day-of-year window over the complete seasons before it (up to five); baseline says how solid that norm is; method_version and config_hash pin the algorithm. ?quality=good keeps one observation class only.

Damage assess + poll

# 3. Damage assessment (202 + job) for the 2025-07-04 storm on SBX-LODGING-1, then poll
export LODGING=$(curl -s "$BASE/parcels?limit=25" -H "$AUTH" \
  | python -c "import sys,json;d=json.load(sys.stdin)['data'];print([p['parcel_id'] for p in d if p['external_ref']=='SBX-LODGING-1'][0])")
export IDEM=$(python -c "import uuid;print(uuid.uuid4())")

export JOB=$(curl -s -X POST "$BASE/damage/assess" -H "$AUTH" \
  -H "Content-Type: application/json" -H "Idempotency-Key: $IDEM" \
  -d '{"parcel_id":"'"$LODGING"'","event_date":"2025-07-04","peril":"storm","claim_ref":"CLM-DEMO-1"}' \
  | python -c "import sys,json;print(json.load(sys.stdin)['job_id'])")

sleep 5
curl -s "$BASE/jobs/$JOB" -H "$AUTH"

Everything that takes longer than a request should returns 202 with a job; eta_seconds on the job counts down and is null once it has finished. The finished job carries result.assessment_id; GET /v1/damage/{'{assessment_id}'} returns the stored assessment and /certificate.pdf the certificate when confidence is at least 0.50. SBX-LODGING-1 on 2025-07-04 answers damage_pct: 85.0 at confidence 0.405 - damage beyond doubt, but with direction_not_confirmed and no certificate; SBX-LODGING-3 on 2024-07-03 (storm) is the sandbox case that clears the threshold, at 0.51. Branch on certificate, never assume the PDF.

Everything else

Reference

Interactive reference with a key box and “Try it”, the static endpoint list and the error catalog that every doc_url points to.

Guides

Authentication, idempotency and rate limits, webhooks, sandbox, billing, data attribution.

SDKs and Postman

agrovisio-data-api for Python and @agrovisio/data-api for TypeScript, both generated from the OpenAPI document, plus a Postman collection with a pre-request script for idempotency keys.

Status and changelog

Live status of the API from your browser, and the changelog with an RSS feed for every addition, deprecation and method version change.

Base URL in production: https://api.agrovisio.ai/v1. Sandbox and live keys share it; the key prefix (sk_test_ / sk_live_) decides which world you see. Contains modified Copernicus Sentinel data.