Introduction to Verdantix GreenOS

Verdantix GreenOS is an enterprise-grade sustainability platform that unifies carbon accounting, renewable energy monitoring, and ESG compliance into a single, developer-friendly interface. Designed for engineers, sustainability officers, and operations teams, GreenOS transforms fragmented environmental data into actionable insights.

New in v3.2: We've added native support for ISO 14064-1 validation, real-time Scope 3 supplier data aggregation, and 40% faster time-series energy queries.

Why GreenOS?

Traditional sustainability tooling silos emissions data, making accurate reporting and decarbonization strategy difficult. GreenOS solves this by:

Unified Data Layer: Ingest metering data, utility bills, and IoT telemetry through standardized connectors.
Automated Compliance: Auto-map your data to GHG Protocol, CSRD, SEC, and TCFD frameworks.
Developer First: RESTful & GraphQL APIs with SDKs for Python, TypeScript, Go, and Rust.
Real-time Visibility: Stream energy consumption and carbon intensity at sub-minute resolution.

Prerequisites

Before you begin, ensure you have the following:

A verified Verdantix account with API_ACCESS permissions
Node.js 18+ or Python 3.10+ installed locally
Access to your organization's GreenOS tenant URL

API Authentication

GreenOS uses Bearer token authentication. Generate your API key from the Dashboard > Settings > API Keys page.

Never expose your secret API keys in client-side code or public repositories. Use environment variables or a secure vault.

Example: Querying Carbon Footprint

bash

curl -X GET https://api.verdantix.io/v3/emissions/scope2 \
  -H "Authorization: Bearer VRT_LIVE_8f7a9b2c..." \
  -H "X-Organization-Id: org_9482k" \
  -d '{
    "start_date": "2025-01-01",
    "end_date": "2025-03-31",
    "location": "US-CA-SF",
    "methodology": "GHG_PROTOCOL_2024"
  }'

Response Format

All API responses follow a consistent envelope structure:

Field	Type	Description
`data`	object \| array	The primary response payload
`metadata`	object	Request timing, cache status, and pagination info
`compliance_flags`	array[object]	Automated validation warnings or errors

Next Steps

Continue your journey with these guides:

Platform Overview

Quickstart Guide