Skip to content

API Overview

About SCO2-API

SCO2-API is a RESTful API interface to a vast collection of open geospatial datasets and satellite imagery collections, which are boiled down to supply chain-specific sustainability metrics around deforestation, land use and management emissions, water and biodiversity.

API Structure

The SCO2-API is organized into several specialized APIs, each designed for specific use cases:

Core API

For real-time analysis of individual plots and small datasets. Provides immediate results for sustainability metrics including deforestation checks, biomass emissions, biodiversity assessment, and water use analysis.

Batch API

For large-scale processing of extensive datasets. Enables asynchronous processing of thousands of plots with comprehensive sustainability analysis, statistical comparisons, and supply shed analysis.

Fetch API

For retrieving previously processed data. Provides streaming access to batch processing results, statistical summaries, and EUDR compliance data.

Key Capabilities

Sustainability Metrics

  • Deforestation Analysis: EUDR-compliant deforestation detection and forest loss assessment
  • Emissions Calculations: Biomass and non-biomass emissions from land use changes and agricultural practices
  • Biodiversity Assessment: Canopy height heterogeneity and landscape connectivity analysis
  • Water Use Analysis: Land surface temperature and evapotranspiration monitoring
  • Carbon Monitoring: Long-term sequestration and restoration tracking

Compliance & Reporting

  • EUDR Compliance: Complete workflow for European Union Deforestation Regulation compliance
  • Risk Assessment: Automated risk evaluation for supply chain transparency
  • Documentation Generation: Automated generation of due diligence statements and audit trails

Data Processing

  • Spatial Analysis: Advanced geometric processing and satellite imagery analysis
  • Statistical Comparison: Regional benchmarking against reference areas
  • Supply Chain Traceability: End-to-end supply shed analysis and risk mapping

Getting Started

Documentation

Quick Start

  1. Authenticate: Obtain your access token using the Authentication Guide
  2. Choose Your API: Select Core API for real-time analysis or Batch API for large-scale processing
  3. Process Data: Upload plots and execute sustainability analysis
  4. Retrieve Results: Use Fetch API to access processed data and generate reports

Integration Examples

Real-time Analysis

Use the Core API for immediate sustainability assessment of individual plots or small batches.

Large-scale Processing

Use the Batch API for comprehensive analysis of entire supply chains with statistical benchmarking.

Compliance Workflows

Leverage the complete EUDR compliance pipeline from data processing to documentation generation.

Epoch's SCO2-API is annotated via OpenAPI. You can browse the reference docs here