For Agents
Estimate greenhouse gas emissions for activities like travel, freight, and energy use, or search the underlying emission factor database. Three endpoints: search, estimate, and batch estimate.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Climatiq API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Climatiq API.
Search the Climatiq emission factor database by activity, region, or source
Estimate CO2-equivalent emissions for a single activity such as a freight leg or a flight
Submit batch estimate requests to score many activities in one call
GET STARTED
Use for: Estimate the CO2 emissions for a 500 km truck freight leg, Search Climatiq for an emission factor for grid electricity in Germany, Calculate emissions for a batch of 50 business flights, Find the emission factor source for a given activity
Not supported: Does not handle carbon credit trading, ESG reporting filings, or company-level disclosure data — use for activity-based emissions calculation only.
Jentic publishes the only available OpenAPI specification for Climatiq API, keeping it validated and agent-ready. Climatiq turns activity data — kilometres travelled, kilowatt-hours consumed, kilograms of material moved — into greenhouse gas emission estimates by applying peer-reviewed emission factors. The spec exposes three endpoints: a search over the emission factor database, a single estimate call, and a batch estimate call for high-volume workloads. Authentication is HTTP bearer with a Climatiq API key, and the API is well suited to sustainability dashboards, freight calculators, and AI agents that need a defensible carbon number for an activity.
Attach a peer-reviewed emission factor and source to every calculated number for audit trails
Power agent-driven sustainability questions with structured, citable carbon estimates
Patterns agents use Climatiq API for, with concrete tasks.
★ Freight Carbon Calculator
Logistics platforms need to display per-shipment CO2 figures alongside cost and ETA. Climatiq /data/v1/estimate accepts a freight activity (mode, distance, weight, region) and returns CO2-equivalent emissions sourced from a named emission factor, so the platform can show a defensible carbon number with a citation rather than a vague estimate.
POST /data/v1/estimate with mode=road, distance_km=500, weight_kg=20000 and parse co2e and co2e_unit from the response
Sustainability Dashboard for Energy Use
Operations teams tracking facility energy use need to convert kWh figures into CO2-equivalent values across regions where the grid mix differs significantly. Climatiq's emission factor search lets the dashboard pick the right factor per region, and /data/v1/estimate calculates the resulting emissions with the source explicitly tagged for each line.
Search /data/v1/search for grid electricity factor in DE then call /data/v1/estimate with energy=12000 kWh to return CO2e for that facility
Bulk Emissions Backfill
Companies running their first carbon report often need to score hundreds or thousands of historical activities (flights, fuel purchases, freight legs) in one pass. /data/v1/estimate/batch accepts a list of activities in a single request and returns parallel results, which is far more efficient than looping single estimate calls and avoids repeated round-trips.
POST /data/v1/estimate/batch with an array of 500 historical travel activities and store the returned co2e values in the reporting warehouse
Agent-Driven Carbon Questions
An AI agent in a finance copilot uses Jentic to answer what is the carbon impact of this purchase questions. Jentic routes the intent to Climatiq's estimate endpoint, the agent loads the schema, executes the bearer-authenticated POST, and returns the CO2-equivalent value with the underlying emission factor source so the answer is auditable.
Use Jentic to search for estimate emissions for an activity, load the schema for POST /data/v1/estimate, and execute with the activity payload
3 endpoints — jentic publishes the only available openapi specification for climatiq api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/data/v1/search
Search emission factors by activity, region, and source
/data/v1/estimate
Calculate emissions for a single activity
/data/v1/estimate/batch
Calculate emissions for a batch of activities
/data/v1/search
Search emission factors by activity, region, and source
/data/v1/estimate
Calculate emissions for a single activity
/data/v1/estimate/batch
Calculate emissions for a batch of activities
Three things that make agents converge on Jentic-routed access.
Credential isolation
Climatiq API keys are stored encrypted in the Jentic MAXsystem vault and injected as the bearer token at execution time. The agent sees only a scoped execution context — never the raw key.
Intent-based discovery
Agents search by intent (for example calculate freight emissions) and Jentic returns POST /data/v1/estimate with its request schema, including the activity object structure, so the agent calls it correctly without reading docs.
Time to first call
Direct integration: a few hours to wire bearer auth and learn the activity payload structure. Through Jentic: under 15 minutes to first successful estimate.
Alternatives and complements available in the Jentic catalogue.
Specific to using Climatiq API through Jentic.
Why is there no official OpenAPI spec for Climatiq API?
Climatiq does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Climatiq API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Climatiq API use?
Climatiq uses HTTP bearer authentication. Send your Climatiq API key as Authorization: Bearer YOUR_KEY on calls to /data/v1/search, /data/v1/estimate, and /data/v1/estimate/batch. Through Jentic the key is held encrypted in the MAXsystem vault and injected at execution time.
Can I calculate emissions for a batch of activities in one call?
Yes. POST /data/v1/estimate/batch accepts an array of activities and returns the CO2-equivalent value plus the emission factor used for each one, in the same order. This is the right endpoint for annual reporting backfills and any workload above a few dozen activities.
What are the rate limits for the Climatiq API?
The OpenAPI spec does not list specific numeric rate limits. In practice Climatiq applies per-plan limits documented on its website. Implement exponential backoff on 429 responses and prefer the batch endpoint over many single-estimate calls to stay under typical limits.
How do I estimate CO2 for a freight leg through Jentic?
Run pip install jentic, search Jentic for estimate freight emissions, load the schema for POST /data/v1/estimate, and execute with a freight activity payload (mode, distance, weight, region). Jentic injects the bearer token from the vault. Get started at https://app.jentic.com/sign-up.
Are Climatiq estimates auditable?
Yes. The estimate response includes the emission factor that was applied, its source, region, and year, so every CO2 figure can be traced back to a specific peer-reviewed factor in the Climatiq database. This is the main reason teams use Climatiq over a hand-coded calculation.