Skip to main content
POST
/
v1
/
periodic-emission-logs
Create a periodic emission log
curl --request POST \
  --url https://api.cula.tech/tracking/v1/v1/periodic-emission-logs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "external_id": "GC-ELEC-2025-10",
  "config_id": "elc_01kqzcjrpyf27tgekeyq3qzm7d",
  "site": {
    "external_id": "GC-SITE-REFINERY"
  },
  "period_start": "2025-10-01T00:00:00.000Z",
  "period_end": "2025-10-31T00:00:00.000Z",
  "data_points": [
    {
      "config_id": "dpc_01kqzcjrpyf27tgeq6a84z0yhy",
      "input_value": {
        "value": 2630450,
        "unit": "kWh"
      }
    },
    {
      "config_id": "dpc_01kqzcjrpyf27tgeq844x9cbr0",
      "input_value": {
        "value": 4280,
        "unit": "kW"
      }
    },
    {
      "config_id": "dpc_01kqzcjrpyf27tgeqhdj0narfq",
      "input_value": {
        "value": 18420,
        "unit": "MMBtu"
      }
    },
    {
      "config_id": "dpc_01kqzcjrpyf27tgeqzk6trybqe",
      "input_value": {
        "value": 2630.45,
        "unit": "MWh"
      }
    },
    {
      "config_id": "dpc_01kqzcjrpyf27tger4hgzn1wxn",
      "input_value": "MRETS"
    },
    {
      "config_id": "dpc_01kqzcjrpyf27tgeq6a84z0yhy",
      "input_value": "0197560e-351f"
    }
  ],
  "file_ids": [
    "fil_01kqzcjrpyf27tgeaqk8twgw91",
    "fil_01kqzcjrpyf27tgeavkt70apdy"
  ]
}
'
{
  "id": "eml_01kqzcjrpyf27tgebyhvvmf20z",
  "external_id": "GC-ELEC-2025-10",
  "config_id": "elc_01kqzcjrpyf27tgekeyq3qzm7d",
  "display_key": "GC-ELEC-2025-10",
  "site": {
    "id": "ste_01kqzcjrpyf27tge6smsbnhkh5",
    "external_id": "GC-SITE-REFINERY"
  },
  "period_start": "2025-10-01T00:00:00.000Z",
  "period_end": "2025-10-31T00:00:00.000Z",
  "status": "calculating",
  "emissions_in_kg_co2e": null,
  "data_points": [
    {
      "config_id": "dpc_01kqzcjrpyf27tgeq6a84z0yhy",
      "config_version_id": "dpv_01kqzcjrpyf27tgerf3nqreg37",
      "name": "Capture electricity",
      "input_value": {
        "value": 2630450,
        "unit": "kWh"
      },
      "value": {
        "value": 2630450,
        "unit": "kWh"
      }
    },
    {
      "config_id": "dpc_01kqzcjrpyf27tgeq844x9cbr0",
      "config_version_id": "dpv_01kqzcjrpyf27tgermj3y3sen0",
      "name": "Peak demand",
      "input_value": {
        "value": 4280,
        "unit": "kW"
      },
      "value": {
        "value": 4280,
        "unit": "kW"
      }
    },
    {
      "config_id": "dpc_01kqzcjrpyf27tgeqhdj0narfq",
      "config_version_id": "dpv_01kqzcjrpyf27tgerr5jnnn960",
      "name": "Natural gas consumption",
      "input_value": {
        "value": 18420,
        "unit": "MMBtu"
      },
      "value": {
        "value": 18420,
        "unit": "MMBtu"
      }
    },
    {
      "config_id": "dpc_01kqzcjrpyf27tgeqzk6trybqe",
      "config_version_id": "dpv_01kqzcjrpyf27tges71h814sdy",
      "name": "REC quantity",
      "input_value": {
        "value": 2630.45,
        "unit": "MWh"
      },
      "value": {
        "value": 2630.45,
        "unit": "MWh"
      }
    },
    {
      "config_id": "dpc_01kqzcjrpyf27tger4hgzn1wxn",
      "config_version_id": "dpv_01kqzcjrpyf27tges8negm940v",
      "name": "REC registry",
      "input_value": "MRETS",
      "value": "MRETS"
    },
    {
      "config_id": "dpc_01kqzcjrpyf27tgeq6a84z0yhy",
      "config_version_id": "dpv_01kqzcjrpyf27tgerf3nqreg37",
      "name": "REC retirement ID",
      "input_value": "0197560e-351f",
      "value": "0197560e-351f"
    }
  ],
  "file_ids": [
    "fil_01kqzcjrpyf27tgeaqk8twgw91",
    "fil_01kqzcjrpyf27tgeavkt70apdy"
  ],
  "created_at": "2026-05-06T19:34:00Z",
  "updated_at": "2026-05-06T19:34:00Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.cula.tech/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API key passed as a Bearer token. Keys are scoped to one organisation and a set of permitted sites. Two keys per scope (primary + secondary) are issued to support zero-downtime rotation.

Authorization: Bearer <api-key>

Body

application/json

Request body for creating a periodic emission log.

​
config_id
string
required

Root periodic emission log config ID. The server resolves to the active config version.

​
site
object
required

The site where the emissions occurred.

Example:
{ "id": "ste_01kqzcjrpyf27tge6smsbnhkh5" }
​
period_start
string<date>
required

Start of the measurement period (ISO date).

Example:

"2025-10-01T00:00:00.000Z"

​
period_end
string<date>
required

End of the measurement period (ISO date).

Example:

"2025-10-31T00:00:00.000Z"

​
external_id
string

Partner-assigned identifier. Must be unique within resource type and organisation. Used for idempotency and ext- lookups.

​
display_key
string

Human-readable display identifier.

​
data_points
object[]

Emission measurement data points.

​
file_ids
string[]

IDs of files to link (invoices, certificates).

Response

Periodic emission log created. Calculation is in progress.

A periodic emission log as returned in responses. After creation, the server triggers a background emission calculation. The status field reflects the calculation state and emissions_in_kg_co2e contains the result once calculation completes.

​
id
string
required

Cula-assigned TypeID.

Example:

"eml_01kqzcjrpyf27tgebyhvvmf20z"

​
config_id
string
required

Root emission log config ID.

Example:

"elc_01kqzcjrpyf27tgekeyq3qzm7d"

​
site
object
required

A resolved resource reference as returned in responses.

​
period_start
string<date>
required

Start of the measurement period.

Example:

"2025-10-01T00:00:00.000Z"

​
period_end
string<date>
required

End of the measurement period.

Example:

"2025-10-31T00:00:00.000Z"

​
status
enum<string>
required

State of the background emission calculation.

  • calculating — calculation is in progress.
  • completed — calculation finished, emissions_in_kg_co2e is populated.
  • failed — calculation failed (contact support).
Available options:
calculating,
completed,
failed
Example:

"completed"

​
data_points
object[]
required

Resolved emission measurement data points.

​
file_ids
string[]
required

IDs of linked files.

Example:
[]
​
created_at
string<date-time>
required
read-only
Example:

"2026-05-06T19:34:00Z"

​
updated_at
string<date-time>
required
read-only
Example:

"2026-05-06T19:34:00Z"

​
external_id
string | null

Partner-assigned external identifier.

Example:

"GC-ELEC-2025-10"

​
display_key
string | null

Human-readable display identifier.

Example:

"GC-ELEC-2025-10"

​
emissions_in_kg_co2e
number | null
read-only

Total emissions for this period in kg CO2 equivalent. Null while status is calculating. Populated once calculation completes.

Example:

8942.37