Insight API

APIs for building energy, sustainability & whole-life carbon

Integrate CAALA's analysis, simulation and optimization engine into your tools. Programmatic access to energy efficiency, sustainability and detailed Whole-Life Carbon Assessment (WLCA) for building designs.

Read the docs Request access

Building facade of angled white panels with a small plant growing in every bay

What you can build

One API for building performance

The CAALA Insight API exposes the analysis, simulation and optimization tools behind CAALA Software so you can build them into your own workflows.

Embed carbon & energy analysis

Run CAALA’s energy-efficiency and sustainability analysis on building designs directly from your own product or pipeline.

Automate Whole-Life Carbon (WLCA)

Generate detailed Whole-Life Carbon Assessments programmatically, with no manual re-entry and a consistent methodology every time.

Optimize designs at scale

Simulate and optimize variants to compare options for energy and sustainability performance across many projects.

Production-ready API

Versioned routes, Bearer authentication, predictable rate limits and a clear error model. All documented in the API reference.

Use cases

Built for the decisions that move projects and portfolios

CAALA’s analysis already supports project developers, asset managers, architects and consultants, from early design and QNG funding to renovation roadmaps. The API lets you put that analysis inside your own product or workflow.

Project developers · Architects

Optimization potential analysis

For climate-neutral project development.

Compare a worst case, the current design and a best case on operational and embodied CO₂, measured against the QNG limits, early while changes are still cheap.

What you can build
Embed variant comparison in your feasibility, design or configurator tool.

Discuss this use case
Project developers · Architects · Energy consultants

QNG conformity check

To know early whether a design qualifies.

Check a design against the QNG-Plus and QNG-Premium limits for greenhouse gas emissions and primary energy demand, with operational and embodied emissions shown separately and a clear pass or fail per limit.

What you can build
Show QNG conformity live in your design or feasibility tool, so teams can adjust before the design is locked in.

Discuss this use case
Project developers · Energy consultants

QNG documentation for KfW funding

To secure funding for climate-friendly new buildings.

Provide the QNG proof for greenhouse gases and primary energy over the life cycle. It is built from your planning documents (an IFC file where available), the thermal insulation proof and a component catalog, and ends in finished documentation for the QNG seal.

What you can build
Make the QNG proof a repeatable step in your funding or certification workflow: submit the project data, receive the documentation.

Discuss this use case
Consultants · Architects · Engineers

Life-cycle assessment for reporting & certification

For sound reporting and certifications.

Produce whole-life carbon results you can stand behind, and export them into the reports and certification workflows you already use.

What you can build
Automate WLCA inside your reporting pipeline instead of re-entering data by hand.

Discuss this use case
Asset managers · Portfolio owners

CO₂ risk analysis

To protect the value of your portfolio.

Make CO₂ exposure visible across your buildings before it becomes a question of asset value.

What you can build
Feed CO₂ results into your portfolio reporting, benchmarking and investment tools.

Discuss this use case
Asset managers · Consultants

Renovation potential analysis

For a sound decarbonization strategy.

Test up to three renovation variants per building, technically and economically. See the effect on consumption, emissions and stranding point, with costs, BEG funding and CO₂ avoidance cost per measure package, and a climate protection roadmap based on CRREM.

What you can build
Power renovation planning and roadmap tools from three years of consumption data, existing plans and basic building data.

Discuss this use case

Proven in CAALA’s reference projects

Published reference projects show how teams use CAALA in practice.

Have a use case in mind?

Tell us what you’re building and we’ll show you how the API fits.

Book a technical call See the CAALA software

For enterprise

Built for serious integrations

A credible, well-documented production API for teams embedding building performance and carbon analysis into their own platforms.

Book a technical call

Reliability

A production API with versioned routes, a health endpoint, and predictable rate limiting.

Security & data handling

Bearer-token auth with short-lived session tokens. GDPR posture and data residency available on request.

Details on request

Versioning discipline

Versioned routes (/v1), so integrations don’t break unexpectedly.

Support

Direct access to the CAALA team for technical evaluation and integration support.

Details on request

Coming soon Enterprise only

Data delivery

Your full tenant data, delivered as a service

A fully managed data backend for enterprise customers. CAALA’s managed services and your own CAALA users feed your tenant data in CAALA’s data lake. Managed APIs let you query all of it and feed your own dashboards, SAP and other ERP systems.

CAALA managed services Analyses and results created by CAALA
Your CAALA users Your team’s work in CAALA

Your tenant data Combined in CAALA’s data lake

Managed data API Operated by CAALA

Internal dashboards
SAP
Other ERP systems

Illustration of a dashboard built on tenant data.

Full tenant query

Query the complete dataset of your tenant, not just single projects or reports.

Built for your systems

Connect internal dashboards, SAP and other ERP software without building your own data pipeline.

Fully managed

CAALA runs the data backend, so your teams spend their time on dashboards and decisions, not on infrastructure.

Planning for it? Talk to us about your data needs.

API overview

Everything you need to integrate

Two places to start: the v1 reference and the machine-readable spec.

Current

v1 reference

Every endpoint of the CAALA Insight API v1 with its request and response models. The right starting point for new integrations.

Open v1 reference

Spec

OpenAPI JSON

The machine-readable v1 specification. Use it to generate client code or import the API into tools such as Postman.

Open OpenAPI JSON

Quickstart

Your first request in two steps

Authentication is a two-step flow: exchange a CAALA-issued access key for a session token, then call the API with a Bearer token.

1

Request an access key

Access keys are issued by CAALA, and there is no public self-service signup yet.
2

Exchange it for a session token

POST the key to /v1/auth/access-keys/exchange-key to receive a short-lived session JWT.
3

Call with a Bearer token

Send Authorization: Bearer <sessionJwt> on every authenticated request.

Full API reference

# Step 1: exchange your access key (10–124 chars) for a session token
curl -X POST https://api.caala.de/v1/auth/access-keys/exchange-key \
  -H "Content-Type: application/json" \
  -d '{ "accessKey": "<your-access-key>" }'
# → { "keyId": "...", "sessionJwt": "..." }

# Step 2: call an authenticated endpoint
curl https://api.caala.de/v1/... \
  -H "Authorization: Bearer <sessionJwt>"

import requests

BASE = "https://api.caala.de"

# Step 1: exchange the access key for a session token
auth = requests.post(
    f"{BASE}/v1/auth/access-keys/exchange-key",
    json={"accessKey": "<your-access-key>"},
    timeout=30,
)
auth.raise_for_status()

# NOTE: confirm JSON casing (sessionJwt) against the live spec before shipping.
token = auth.json()["sessionJwt"]

# Step 2: call the API with the Bearer token
response = requests.get(
    f"{BASE}/v1/...",
    headers={"Authorization": f"Bearer {token}"},
    timeout=30,
)

using System.Net.Http.Json;

var http = new HttpClient { BaseAddress = new Uri("https://api.caala.de/") };

// Step 1: exchange the access key for a session token
var auth = await http.PostAsJsonAsync(
    "v1/auth/access-keys/exchange-key",
    new { accessKey = "<your-access-key>" });
auth.EnsureSuccessStatusCode();

// NOTE: confirm JSON casing (sessionJwt) against the live spec before shipping.
var token = await auth.Content.ReadFromJsonAsync<ExchangeResponse>();

// Step 2: call the API with the Bearer token
http.DefaultRequestHeaders.Authorization =
    new("Bearer", token!.SessionJwt);

var response = await http.GetAsync("v1/...");

record ExchangeResponse(string KeyId, string SessionJwt);

FAQ

Common questions

Can’t find an answer? Email info@caala.de or reach the team via the support page.

How do I get an access key?

Access keys are issued by CAALA, and there is no public self-service signup today. Request one via the contact page and the team will get you set up.

How does authentication work?

Two steps: POST your access key to /v1/auth/access-keys/exchange-key to get a short-lived session token, then send Authorization: Bearer <sessionJwt> on authenticated requests.

What are the rate limits?

Fixed one-minute windows: 100 requests/min on public endpoints and 50 requests/min on strict endpoints. Exceeding the limit returns 429 immediately, and requests are not queued.

Is there a sandbox or test environment?

To be confirmed. Ask the CAALA team about test access keys and a sandbox environment for evaluation.

How is my data handled (GDPR)?

CAALA GmbH is a German company and operates under GDPR. Data residency, sub-processors and a DPA are available on request. See the privacy policy and contact the team for specifics.

What does it cost?

Commercial terms are handled directly with CAALA. Get in touch via the contact page to discuss access and pricing.

Start building with CAALA

Request an access key to get started, or talk to our team about an enterprise integration.

Request access Talk to sales