API workflows & capabilities
The different ways you can interact with Satelligence nature and climate risk data through our API.
Satelligence offers different ways to interact with our nature & climate risk data. Whether you need an instant risk check or a fully managed supply chain monitoring system, our API adapts to your needs and allows you to build your own tools and analysis on top.
1. On-the-Fly Workflow (Instant Risk Info)
Best for:
Rapid, one-off risk assessments where you don't need continuous monitoring or store data on our platform.
- How it works: You send a single geometry (the boundary of an area) directly in your API request.
- The Result: You receive an immediate JSON response including forest cover and deforestation history.
- Why use it: It’s the fastest way to get data into your own systems without any upload needed.
2. Supply Chain Managed Workflow (Upload & Monitor)
Best for:
Comprehensive supply chain management, framework compliance (EUDR, NDPE, RSPO, CFI, Fairtrade), and advanced GIS analysis.
When you upload plots to the Satelligence platform, you are not just getting data, you are building a managed database of your supply chain.
- Enhanced Data Quality: During the upload phase, our API performs Sanity & Quality Checks. We automatically flag issues like holes in shapes, self-intersections, or invalid geometries.
- EUDR & TRACES Compliance: Our system validates your geolocation data against TRACES requirements. We make sure that plot geometries are valid (e.g. no self-intersection or holes). We also check if the location matches with what is stated, for example, if you provide a country name we will flag any plots that fall outside that country's borders.
- Advanced Geospatial Formats: Beyond simple data points, you get access to downloadable GeoPackages and CSVs containing the actual shapes of deforestation within your supply chain.
- Visual Webmaps: Each plot response includes a plotUrl, providing a visual dashboard of the plot and related forests and deforestation (if any).
- Flexible Aggregation: You can organize your data using the Supplier field. While named "Supplier," this is a flexible field you can use for batch numbers, regions, or any internal ID you prefer.
3. Global Insights: The Jurisdictions Endpoint
Available to all users, regardless of workflow.
You do not need to upload any plots to access our global database. The Jurisdiction Endpoint allows you to pull risk assessments for any recognized jurisdiction in the world.
- What you get: A JSON summary of forest cover, deforestation trends, commodity cover and the presence of protected or indigenous lands within that specific region.
Quick Comparison Table
- Storage of geometry
- Risk Info (On-the-Fly): No
- Upload + Plot Info (Managed Supply Chain): Yes
- Jurisdictions: N/A
- Quality Checks
- Risk Info (On-the-Fly): Basic
- Upload + Plot Info (Managed Supply Chain): Users can and handle supply chain management by enabling or not full EUDR/TRACES.
If not enable quality issues will be flagged anyway in plot information later on. - Jurisdictions: N/A
- GIS Formats
- Risk Info (On-the-Fly): GeoJSON
- Upload + Plot Info (Managed Supply Chain): Input: GeoJSON
Output: JSON, GeoJSON, GeoPackage, CSV, Webmap - Jurisdictions: JSON
- Visual Mapping
- Risk Info (On-the-Fly): No
- Upload + Plot Info (Managed Supply Chain): Yes, Interactive Webmap
- Jurisdictions: No
- Speed
- Risk Info (On-the-Fly): Real-time
- Upload + Plot Info (Managed Supply Chain): Real-time once plots are uploaded. The endpoint to get deforestation detections is slower compared to the one used to get plots information.
- Jurisdictions: Real-time
- Ideal Use Case
- Risk Info (On-the-Fly): Quick internal checks
- Upload + Plot Info (Managed Supply Chain): Supply chain, EUDR reporting, Continuous Supply Chain Monitoring
- Jurisdictions: Regional risk scouting