Carbon Accounting Intelligence API (cai-api)

The Carbon Accounting Intelligence API lets you upload and process arbitrary files and turn them into structured carbon accounting data. Use it to ingest documents, track processing jobs, review classifications and measurements, and export classifications as CSV.

How CAI models data

• Classification: structured data that represents a carbon-emitting activity, including GHG scope classification and scope/category-specific data points extracted from the source document.
• Measurement: a 1:1 result for each classification that represents the calculated emissions based on an automatically matched emission factor.
• Project: a workspace that groups uploaded files and their classifications/measurements; most API requests require a project_id.

What you can do

• Upload files for processing.
• Track job status and list uploaded files.
• Review classifications and measurements, then verify or update them.
• Export classifications as CSV.

Processing flow

1. Upload a document.
2. CAI extracts activities from the document.
3. Each activity is GHG-classified and structured data points are extracted.
4. When all required data is available, measurement processing starts.
5. If CAI can auto-verify the data, the measurement is_verified flag is set to true, which means measurement can be started.

Core identifiers

• project_id: UUID for your project, required on most endpoints.
• file_key: UUID plus extension returned after upload.
• task_id (job_id): returned for processing jobs, used to check status.
• classification_id and measurement_id: used for review and updates.