Skip to main content
GET
/
material-processing-configs
/
{id}
/
versions
/
{version_id}
Get a specific config version
curl --request GET \
  --url https://api.demo.cula.earth/tracking/v1/material-processing-configs/{id}/versions/{version_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Cula-Organisation-Id: <cula-organisation-id>'
{
  "id": "scv_01kqzcjrpyf27tgefy70hchba7",
  "config_id": "stc_01kqzcjrpyf27tgeevggzctpyk",
  "next_version_id": null,
  "name": "Biomass Processing",
  "published_at": "2026-01-15T08:00:00Z",
  "data_point_configs": [
    {
      "id": "dpc_01kqzcjrpyf27tgev1hkzm2wxp",
      "name": "Produced lot number",
      "type": "short_text",
      "is_mandatory": false,
      "accepts_input": true
    },
    {
      "id": "dpc_01kqzcjrpyf27tgev3a94z1yhz",
      "name": "Capture method",
      "type": "short_text",
      "is_mandatory": false,
      "accepts_input": true,
      "select_config": {
        "options": [
          {
            "label": "Post-combustion",
            "value": "post_combustion"
          },
          {
            "label": "Pre-combustion",
            "value": "pre_combustion"
          },
          {
            "label": "Oxy-fuel",
            "value": "oxy_fuel"
          }
        ]
      }
    },
    {
      "id": "dpc_01kqzcjrpyf27tgev5b05a2cbs",
      "name": "Capture electricity",
      "type": "amount",
      "is_mandatory": false,
      "accepts_input": true,
      "amount_base": "watt_hours"
    }
  ],
  "input_config": {
    "id": "mcc_01kqzcjrpyf27tgevnzz3utny6z",
    "name": "Biomass Input",
    "data_point_configs": [
      {
        "id": "dpc_01kqzcjrpyf27tgev7c16b3dct",
        "name": "Corn input quantity",
        "type": "amount",
        "is_mandatory": true,
        "accepts_input": true,
        "amount_base": "weight"
      }
    ]
  },
  "output_config": {
    "id": "mcc_01kqzcjrpyf27tgevpaa4vupz7a",
    "name": "CO2 Output",
    "data_point_configs": [
      {
        "id": "dpc_01kqzcjrpyf27tgev9d27c4edu",
        "name": "CO2 output quantity",
        "type": "amount",
        "is_mandatory": true,
        "accepts_input": true,
        "amount_base": "weight"
      },
      {
        "id": "dpc_01kqzcjrpyf27tgevbd38d5fev",
        "name": "CO2 purity",
        "type": "percentage",
        "is_mandatory": true,
        "accepts_input": true
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

OAuth2 client credentials flow. Exchange your client_id and client_secret for a short-lived access token, then pass it as a Bearer token in the Authorization header.

Headers

​
Cula-Organisation-Id
string
required

Organisation ID that scopes this request. The authenticated consumer must be authorized for this organisation. Omitting this header returns 400; passing an unauthorised org returns 403.

Path Parameters

​
id
string
required

Cula-assigned resource ID in TypeID format (e.g. stp_01kqzcjrpxf27tge33jwvjhkff). Alternatively, pass your external ID prefixed with ext- (e.g. ext-MY-STEP-001). The ext- prefix is unambiguous because TypeIDs use _ separators and never start with ext-.

​
version_id
string
required

Config version ID.

Response

Config version detail.

A published version of a material processing config with inline data point configs, input container config, and output container config.

​
id
string
required

Config version ID.

Example:

"scv_01kqzcjrpyf27tgefy70hchba7"

​
config_id
string
required

Parent config ID.

Example:

"stc_01kqzcjrpyf27tgeevggzctpyk"

​
name
string
required

Human-readable name of this config version.

Example:

"Biomass Processing"

​
published_at
string<date-time>
required

When this version was published.

Example:

"2026-01-15T08:00:00Z"

​
data_point_configs
object[]
required

Step-level data point configs. Use these id values as config_id in the top-level data_points array when creating a step.

​
input_config
object
required

Input container config. Describes the data points expected on each input container in input_containers[].data_points.

​
output_config
object
required

Output container config. Describes the data points expected on each output container in output_containers[].data_points.

​
next_version_id
string | null

ID of the next version in the chain. Null if this is the active (latest published) version.

Example:

null