CO2Router
Developers / API

Marketplace-ready API catalog.

This page lists the exposed public control-plane surface and the brokered engine endpoints. Use the public API for customer integrations and the brokered engine surface for authorized routing, replay, and grid intelligence.

Open Live DemoOpen Quickstart
Use it correctly

Use JSON requests with `content-type: application/json`.

Protected routes require org auth or broker auth. `401` and `403` are expected when access is missing.

Brokered engine endpoints never go direct from the client. They go through the runtime bridge.

Nulls, estimated values, fallback states, and disagreement flags are part of the contract and should be rendered.

Broker boundary
Official broker base -> https://api.co2router.com
Public SaaS API -> runtime /api/v1/*
Brokered engine API -> runtime /api/v1/* allowlist
Direct engine URLs are not for client use

Public API

Health and readiness
/api/v1/health
/api/v1/ready
/api/v1/bootstrap
Runs and replay
/api/v1/runs
/api/v1/runs/:id
/api/v1/runs/:id/events
Policies and approvals
/api/v1/policies
/api/v1/approvals
/api/v1/approvals/:id
Billing and access
/api/v1/billing/checkout
/api/v1/billing/public-checkout
/api/v1/billing/portal
/api/v1/billing/status
/api/v1/keys
/api/v1/service-accounts
Compliance and operations
/api/v1/compliance/reports
/api/v1/audit/exports
/api/v1/alerts
/api/v1/methodology/providers
/api/v1/webhooks

Brokered Engine API

Routing
/api/v1/sandbox/run
/api/v1/route/green
/api/v1/route
/api/v1/route-simple
Grid intelligence
/api/v1/intelligence/grid/hero-metrics
/api/v1/intelligence/grid/summary
/api/v1/intelligence/grid/opportunities
/api/v1/intelligence/grid/region/:region
/api/v1/intelligence/grid/import-leakage
/api/v1/intelligence/grid/audit/:region
/api/v1/intelligence/grid/structural-profile/:region
Dashboard and CI/CD
/api/v1/dashboard/metrics
/api/v1/dashboard/regions
/api/v1/ci/authorize