Skip to main content
GET
/
v1
/
incoming-delivery-configs
/
{id}
/
versions
/
{version_id}
Get a specific config version
curl --request GET \
  --url https://api.cula.tech/tracking/v1/v1/incoming-delivery-configs/{id}/versions/{version_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "dcv_01kqzcjrpyf27tgej0x1ke3msk",
  "config_id": "dlc_01kqzcjrpyf27tgegxm6bxfdhb",
  "next_version_id": null,
  "name": "Corn Incoming Delivery",
  "allow_multiple_legs": false,
  "published_at": "2026-01-15T08:00:00Z",
  "data_point_configs": [
    {
      "id": "dpc_01kqzcjrpyf27tger4hgzn1wxn",
      "name": "Driver name",
      "type": "short_text",
      "is_mandatory": false,
      "has_dependencies": false
    },
    {
      "id": "dpc_01kqzcjrpyf27tgeq6a84z0yhy",
      "name": "Lot ID",
      "type": "short_text",
      "is_mandatory": true,
      "has_dependencies": false
    },
    {
      "id": "dpc_01kqzcjrpyf27tgeq844x9cbr0",
      "name": "Scale ticket number",
      "type": "short_text",
      "is_mandatory": true,
      "has_dependencies": false
    }
  ],
  "payload_config": {
    "id": "mcc_01kqzcjrpyf27tgenyy2stmy5z",
    "name": "Corn Payload",
    "data_point_configs": [
      {
        "id": "dpc_01kqzcjrpyf27tgeq844x9cbr0",
        "name": "Weight gross",
        "type": "amount",
        "is_mandatory": true,
        "has_dependencies": false,
        "amount_base": "weight"
      },
      {
        "id": "dpc_01kqzcjrpyf27tgeqhdj0narfq",
        "name": "Weight net",
        "type": "amount",
        "is_mandatory": true,
        "has_dependencies": true
      },
      {
        "id": "dpc_01kqzcjrpyf27tgeqzk6trybqe",
        "name": "Moisture content",
        "type": "percentage",
        "is_mandatory": true,
        "has_dependencies": false,
        "validation": {
          "min": 0,
          "max": 0.5
        }
      }
    ]
  },
  "selectable_transport_emission_log_configs": [
    {
      "id": "elc_01kqzcjrpyf27tgekeyq3qzm7d",
      "name": "Road Transport (Diesel)",
      "transport_mode": "road",
      "data_point_configs": [
        {
          "id": "dpc_01kqzcjrpyf27tgeq6a84z0yhy",
          "name": "Transport distance",
          "type": "amount",
          "is_mandatory": false,
          "has_dependencies": false,
          "amount_base": "length"
        }
      ]
    }
  ],
  "default_transport_emission_log_config_id": "elc_01kqzcjrpyf27tgekeyq3qzm7d",
  "schema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "required": [
      "config_id",
      "issuing_site",
      "legs",
      "payload"
    ],
    "properties": {
      "data_points": {
        "type": "array",
        "x-required-config-ids": [
          "dpc_01kqzcjrpyf27tgeq6a84z0yhy",
          "dpc_01kqzcjrpyf27tgeq844x9cbr0"
        ]
      },
      "legs": {
        "type": "array",
        "minItems": 1,
        "items": {
          "type": "object",
          "required": [
            "sender_site",
            "receiver_site"
          ],
          "properties": {
            "data_points": {
              "type": "array",
              "x-required-config-ids": []
            }
          }
        }
      },
      "payload": {
        "type": "array",
        "minItems": 1,
        "items": {
          "type": "object",
          "properties": {
            "data_points": {
              "type": "array",
              "x-required-config-ids": [
                "dpc_01kqzcjrpyf27tgeq844x9cbr0",
                "dpc_01kqzcjrpyf27tgeqhdj0narfq",
                "dpc_01kqzcjrpyf27tgeqzk6trybqe"
              ]
            }
          }
        }
      }
    }
  }
}

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>

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 an incoming delivery config with inline data point configs, payload config, and transport emission log configs.

​
id
string
required

Config version ID.

Example:

"dcv_01kqzcjrpyf27tgej0x1ke3msk"

​
config_id
string
required

Parent config ID.

Example:

"dlc_01kqzcjrpyf27tgegxm6bxfdhb"

​
name
string
required

Human-readable name of this config version.

Example:

"Corn Incoming Delivery"

​
published_at
string<date-time>
required

When this version was published.

Example:

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

​
data_point_configs
object[]
required

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

​
payload_config
object
required

Payload container config. Describes the data points expected on each payload container in payload[].data_points.

​
selectable_transport_emission_log_configs
object[]
required

Transport emission log configs that can be selected for delivery legs via selected_emission_log_config_id.

​
next_version_id
string | null

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

Example:

null

​
allow_multiple_legs
boolean

Whether deliveries using this config can have more than one leg.

Example:

false

​
default_transport_emission_log_config_id
string | null

ID of the default transport emission log config. References one of the items in selectable_transport_emission_log_configs. Used when the leg omits selected_emission_log_config_id.

Example:

"elc_01kqzcjrpyf27tgekeyq3qzm7d"

​
schema
object

JSON Schema (draft 2020-12) describing the expected request body shape for creating a runtime resource with this config version. The schema encodes which data points are required at each nesting level (delivery-level, leg-level, payload container-level). Partners can use this for client-side validation before sending requests. See Request body schema for details on how to use this field.

Example:
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "required": [
    "config_id",
    "issuing_site",
    "legs",
    "payload"
  ],
  "properties": {
    "data_points": {
      "type": "array",
      "description": "Delivery-level data points",
      "x-required-config-ids": [
        "dpc_01kqzcjrpyf27tgeq6a84z0yhy",
        "dpc_01kqzcjrpyf27tgeq844x9cbr0"
      ]
    },
    "legs": {
      "type": "array",
      "minItems": 1,
      "items": {
        "type": "object",
        "required": ["sender_site", "receiver_site"],
        "properties": {
          "data_points": {
            "type": "array",
            "x-required-config-ids": []
          }
        }
      }
    },
    "payload": {
      "type": "array",
      "minItems": 1,
      "items": {
        "type": "object",
        "properties": {
          "data_points": {
            "type": "array",
            "x-required-config-ids": [
              "dpc_01kqzcjrpyf27tgeq844x9cbr0",
              "dpc_01kqzcjrpyf27tgeqhdj0narfq",
              "dpc_01kqzcjrpyf27tgeqzk6trybqe"
            ]
          }
        }
      }
    }
  }
}