All systems operational • v2.4.1 • API Status: Healthy

Build with the Env API

Access real-time environmental metrics, automate compliance reporting, and integrate sustainability data into your applications with our RESTful API.

● Stable REST API OAuth 2.0 GraphQL Beta

Quick Start

Get up and running in under 3 minutes. Generate your API key from the dashboard, then make your first request.

Request

curl https://api.env.dev/v2/emissions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "scope": 1,
    "period": "monthly",
    "format": "iso14064"
  }'

import env_sdk

client = env_sdk.Client(api_key="YOUR_API_KEY")

# Fetch monthly emissions data
data = client.emissions.list(
    scope=1,
    period="monthly",
    format="iso14064"
)

print(data)

import { EnvClient } from "@env/sdk";

const client = new EnvClient({
  apiKey: "YOUR_API_KEY"
});

// Fetch monthly emissions
const data = await client.emissions.list({
  scope: 1,
  period: "monthly",
  format: "iso14064"
});

console.log(data);

API Reference

All endpoints are prefixed with https://api.env.dev/v2/. Responses are returned as JSON.

Method	Endpoint	Description	Auth
GET	/emissions	Retrieve carbon emissions by scope & period	Bearer Token
POST	/energy/meter	Upload smart meter telemetry data	Bearer Token
GET	/compliance/reports	Generate GRI/SASB/TCLD reports	Bearer Token
PUT	/supply-chain/risk	Update vendor sustainability scores	Bearer Token

Error Handling

The API uses standard HTTP status codes. All errors are returned in a consistent JSON format:

JSON Response

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests. Limit: 1000/min.",
    "retry_after": 45
  },
  "request_id": "req_8f92a1b3c4d5"
}

SDKs & Tools

Official client libraries and command-line tools for popular languages and environments.

Python SDK

Async-first library with full type hints, pagination helpers, and streaming webhooks support.

pip install env-sdk →

JavaScript / TypeScript

Node.js & browser-compatible client with ESM/CJS support and auto-generated types.

npm i @env/sdk →

CLI Tool

Manage environments, test endpoints, and deploy compliance scripts directly from your terminal.

brew install env-cli →

Go Client

High-performance synchronous client with built-in retry logic and circuit breakers.

go get github.com/env/go-sdk →

Webhooks & Events

Receive real-time notifications when environmental thresholds are breached, reports are generated, or supply chain metrics update.

Payload Example

{
  "event": "emissions.threshold_breach",
  "timestamp": "2025-04-12T14:30:00Z",
  "data": {
    "scope": 2,
    "value_tco2e": 14200.5,
    "limit_tco2e": 12000,
    "region": "EU-West"
  },
  "signature": "sha256:a1b2c3d4..."
}