We use analytics to improve the site

    We use analytics to understand what's working and where things can be clearer, so we can make the site easier to use for everyone.

    Privacy & cookies
    Skip to main content

    EcoHedge Infrastructure

    The compliance-aligned emissions engine for regulated software.

    Two APIs, shared infrastructure. Use the Factor API for emission factor lookup and calculation, or the Categorisation API to classify raw financial transactions into auditable emissions automatically.

    277k+

    emissions factors

    13

    source databases

    261

    countries covered

    2 APIs

    factors + categorisation

    Every calculation returns source, licence, methodology and timestamp metadata.

    Why teams choose EcoHedge Infrastructure

    Built for regulated environments

    Designed for financial software, accounting platforms, procurement systems and enterprise tools that require audit transparency.

    Defensible numbers

    Every response includes source database, year, licence, attribution and reproducible formula context.

    Keep your UX

    Run carbon calculations inside your own interface. No tool switching. No white labelling required.

    Ship faster

    Production-ready endpoints for search, lookup, calculate and batch processing. No factor wrangling.

    Not just an emissions API

    Most APIs return a number.
    EcoHedge Infrastructure returns audit context.

    We align factor metadata with real-world reporting frameworks such as SECR and UK Sustainability Reporting Standards. That means your outputs are structured for compliance from day one.

    Source provenance on every factor
    Licence and attribution visibility
    Version and year traceability
    Categorisation API

    From raw transactions to categorised emissions

    Send financial transactions — supplier name, description, amount — and receive structured emission results with category classification, confidence scoring, and review flags. No manual mapping required.

    Powered by a multi-signal classification pipeline that improves with every transaction processed across the network.

    Operation modes

    Auto

    mode: "auto"

    Classify and calculate emissions in a single call. Best for production pipelines where you want results immediately.

    Suggest

    mode: "suggest"

    Returns ranked category suggestions with confidence scores. Ideal when a human reviews before committing.

    Classify only

    mode: "classify_only"

    Returns the matched category and metadata without running the emissions calculation. Useful for enrichment workflows.

    Example request

    curl -X POST https://app.ecohedge.ai/api/v2/categorize \
      -H "X-API-Key: YOUR_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "transactions": [
          {
            "id": "txn_001",
            "supplier": "ABC Office Supplies",
            "description": "A4 paper and toner cartridges",
            "amount": 284.50,
            "currency": "GBP"
          }
        ],
        "mode": "auto"
      }'

    Example response

    {
      "results": [
        {
          "transaction_id": "txn_001",
          "category": "Office supplies and stationery",
          "confidence": 0.94,
          "review_flag": false,
          "emissions": {
            "co2e_kg": 112.38,
            "factor_id": "ef_desnz_2024_office_supplies",
            "source": "UK DESNZ 2024",
            "methodology": "spend-based"
          }
        }
      ],
      "meta": {
        "transactions_processed": 1,
        "flagged_for_review": 0
      }
    }

    Transactions with a confidence score below your configured threshold are automatically flagged for human review.

    Quickstart

    From zero to first calculation in minutes

    Four steps to your first audit-ready output.

    1

    Register for a key

    Sign up at developers.ecohedge.ai to get a free API key (500 req/month).

    2

    Search factors

    curl "https://app.ecohedge.ai/api/v1/public/factors/search?q=electricity&country=GB&limit=5" \
      -H "X-API-Key: YOUR_API_KEY"
    3

    Calculate with API key

    curl -X POST https://app.ecohedge.ai/api/v1/public/calculate \
      -H "Content-Type: application/json" \
      -H "X-API-Key: YOUR_API_KEY" \
      -d '{
        "factor_id": "exiobase_gb_computer_programming_consultancy_and_related_activities",
        "amount": 10000
      }'
    4

    Batch calculate

    curl -X POST https://app.ecohedge.ai/api/v1/public/calculate/batch \
      -H "Content-Type: application/json" \
      -H "X-API-Key: YOUR_API_KEY" \
      -d '{
        "calculations": [
          { "factor_id": "exiobase_gb_computer_programming_consultancy_and_related_activities", "amount": 10000 },
          { "factor_id": "exiobase_gb_legal_and_accounting_activities", "amount": 5000 }
        ]
      }'

    Every response is audit-ready

    Calculation outputs include input context, factor details and audit metadata so your downstream reporting remains transparent and reproducible.

    {
      "success": true,
      "data": {
        "input": {
          "factor_id": "exiobase_gb_computer_programming_consultancy_and_related_activities",
          "amount": 10000,
          "unit": "unit"
        },
        "result": {
          "kgCO2e": 1234.5678,
          "tCO2e": 1.2346
        },
        "factor": {
          "factorId": "exiobase_gb_computer_programming_consultancy_and_related_activities",
          "name": "Computer programming, consultancy and related activities",
          "unit": "kgCO2e/gbp"
        },
        "audit": {
          "factorSource": "EXIOBASE",
          "factorYear": 2024,
          "licence": "CC-BY-SA 4.0",
          "timestamp": "2026-01-01T12:00:00.000Z"
        }
      }
    }

    Endpoint Reference

    All endpoints use base URL https://app.ecohedge.ai

    EndpointMethodAuthPurpose
    Factor API
    /api/v1/public/factors/search
    GET
    X-API-Key
    Full-text search factors
    /api/v1/public/factors/{factorId}
    GET
    X-API-Key
    Get one factor
    /api/v1/public/factors
    GET
    X-API-Key
    Browse/filter factors
    /api/v1/public/sources
    GET
    Public
    Source and licence metadata
    /api/v1/public/countries
    GET
    Public
    Countries with factor counts
    /api/v1/public/sectors
    GET
    Public
    Sectors and categories
    /api/v1/public/stats
    GET
    Public
    Dataset summary stats
    /api/v1/public/calculate
    POST
    X-API-Key
    Single calculation
    /api/v1/public/calculate/batch
    POST
    X-API-Key
    Up to 100 calculations
    /api/v1/public/openapi.json
    GET
    Public
    OpenAPI spec
    /api/v1/developers/register
    POST
    Authenticated
    Create free API key
    /api/v1/developers/usage
    GET
    X-API-Key
    Check usage/quota
    /api/v1/developers/rotate
    POST
    X-API-Key
    Rotate key
    /api/v1/developers/revoke
    POST
    X-API-Key
    Revoke key
    Categorisation API
    /api/v2/categorize
    POST
    X-API-Key
    Categorise transactions and calculate emissions

    Where EcoHedge Infrastructure fits

    Built for teams that already have software.

    Carbon features in SaaS

    Embed compliant emission estimates directly into dashboards your customers already trust.

    ERP and accounting enrichment

    Use the Categorisation API to auto-classify transactions at import or reconciliation, turning raw spend into auditable emissions without manual mapping.

    Procurement and supplier tooling

    Score purchase orders and supplier carbon intensity inside your existing workflow.

    Consulting and reporting outputs

    Generate reproducible, auditor-verifiable carbon results backed by full metadata traceability.

    Spend-based Scope 3

    Process bulk financial transactions through the Categorisation API to produce organisation-wide Scope 3 estimates with confidence scoring and review flags.

    Built for audit scrutiny

    Designed to withstand internal governance review, client challenge and external audit.

    What you receive

    Factor source database
    Factor year and unit
    Licence information
    Methodology context
    Timestamped calculation

    What stakeholders can verify

    Source database
    Year and region
    Unit mapping
    Calculation formula
    Attribution requirements

    Pricing

    Simple, predictable pricing

    Start free. Scale when you need to.

    Free

    £0/month

    500 requests/month

    Explore and prototype with full API access.

    • All endpoints
    • Full factor library
    • Community support
    Get started
    Most popular

    Starter

    £29/month

    10,000 requests/month

    For teams integrating carbon data into production.

    • All endpoints
    • Full factor library
    • Email support
    • Usage dashboard
    Start building

    Growth

    £99/month

    100,000 requests/month

    High-volume access for scaled applications.

    • All endpoints
    • Full factor library
    • Priority support
    • Usage dashboard
    • SLA guarantee
    Contact us

    FAQ

    Build carbon intelligence into your platform.

    Start with a free key. Scale to enterprise compliance infrastructure.