Skip to main content
POST
/
v1
/
outgoing-deliveries
Create an outgoing delivery
curl --request POST \
  --url https://api.cula.tech/tracking/v1/v1/outgoing-deliveries \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "external_id": "GC-OUT-20260501",
  "config_id": "dlc_01kqzcjrpyf27tgehft3xhahn8",
  "display_key": "GC-OUT-20260501",
  "issuing_site": {
    "external_id": "GC-SITE-REFINERY"
  },
  "sent_at": "2026-05-01T08:00:00-05:00",
  "legs": [
    {
      "sender_site": {
        "external_id": "GC-SITE-REFINERY"
      },
      "receiver_site": {
        "external_id": "GC-WELL-SITE"
      },
      "data_points": []
    }
  ],
  "payload": [
    {
      "data_points": [
        {
          "config_id": "dpc_01kqzcjrpyf27tgeq844x9cbr0",
          "input_value": {
            "value": 18500,
            "unit": "kg"
          }
        },
        {
          "config_id": "dpc_01kqzcjrpyf27tgeqhdj0narfq",
          "input_value": {
            "value": 99.97,
            "unit": "%"
          }
        }
      ]
    }
  ],
  "data_points": [
    {
      "config_id": "dpc_01kqzcjrpyf27tger4hgzn1wxn",
      "input_value": "GC-SHIP-20260501-001"
    }
  ],
  "file_ids": []
}
'
{
  "id": "dlv_01kqzcjrpxf27tge48sdha1emj",
  "config_id": "dlc_01kqzcjrpyf27tgegxm6bxfdhb",
  "config_version_id": "dcv_01kqzcjrpyf27tgej0x1ke3msk",
  "issuing_site": {
    "id": "<string>",
    "external_id": "<string>"
  },
  "legs": [
    {
      "id": "leg_01kqzcjrpyf27tge5gameqfe75",
      "sender_site": {
        "id": "<string>",
        "external_id": "<string>"
      },
      "receiver_site": {
        "id": "<string>",
        "external_id": "<string>"
      },
      "data_points": [
        {
          "config_id": "dpc_01kqzcjrpyf27tgeq6a84z0yhy",
          "config_version_id": "dpv_01kqzcjrpyf27tgerf3nqreg37",
          "name": "Weight net",
          "input_value": {
            "value": 47079.76,
            "unit": "lb"
          },
          "value": {
            "value": 21353.12,
            "unit": "kg"
          }
        }
      ],
      "selected_emission_log_config_id": "<string>"
    }
  ],
  "payload": [
    {
      "id": "mct_01kqzcjrpyf27tgenyy2stmy5z",
      "data_points": [
        {
          "config_id": "dpc_01kqzcjrpyf27tgeq6a84z0yhy",
          "config_version_id": "dpv_01kqzcjrpyf27tgerf3nqreg37",
          "name": "Weight net",
          "input_value": {
            "value": 47079.76,
            "unit": "lb"
          },
          "value": {
            "value": 21353.12,
            "unit": "kg"
          }
        }
      ],
      "contents": [
        {
          "material": {
            "id": "mat_01kqzcjrpyf27tge9dnvsqv8t2",
            "external_id": "corn-no2-yellow"
          },
          "weight_in_kg": 21353.12
        }
      ]
    }
  ],
  "data_points": [
    {
      "config_id": "dpc_01kqzcjrpyf27tgeq6a84z0yhy",
      "config_version_id": "dpv_01kqzcjrpyf27tgerf3nqreg37",
      "name": "Weight net",
      "input_value": {
        "value": 47079.76,
        "unit": "lb"
      },
      "value": {
        "value": 21353.12,
        "unit": "kg"
      }
    }
  ],
  "file_ids": [],
  "created_at": "2026-05-06T19:34:00Z",
  "updated_at": "2026-05-06T19:34:00Z",
  "external_id": "GC-DEL-N001016013",
  "display_key": "GC-DEL-N001016013",
  "sent_at": "2026-05-01T13:00: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 an outgoing delivery.

​
config_id
string
required

Root delivery config ID. The server resolves to the active config version. Discover available configs via the config list endpoint.

​
legs
object[]
required

Transport segments. At least one leg is required. Each leg defines a sender → receiver pair with optional leg-level data points and transport emission log config.

Minimum array length: 1
​
payload
object[]
required

Payload containers. At least one required. Each container carries its own data points (e.g. weight gross, weight net, moisture). The server computes material contents from the data point values.

Minimum array length: 1
​
issuing_site
object
required

The site creating the delivery. For outgoing deliveries, this must be the sender site of the first leg.

Example:
{ "id": "ste_01kqzcjrpyf27tge6smsbnhkh5" }
​
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[]

Delivery-level data points (e.g. driver name, lot ID, scale ticket).

​
file_ids
string[]

IDs of files to link to this delivery.

​
sent_at
string<date-time>

When the delivery was sent from the issuing site. ISO-8601 with explicit UTC offset required.

Response

Outgoing delivery created.

An outgoing delivery as returned in responses.

​
id
string
required

Cula-assigned TypeID.

Example:

"dlv_01kqzcjrpxf27tge48sdha1emj"

​
config_id
string
required

Root delivery config ID.

Example:

"dlc_01kqzcjrpyf27tgegxm6bxfdhb"

​
config_version_id
string
required
read-only

Resolved config version used at creation time.

Example:

"dcv_01kqzcjrpyf27tgej0x1ke3msk"

​
issuing_site
object
required

The site that created this delivery.

​
legs
object[]
required

Transport segments with resolved sender/receiver sites and data points.

​
payload
object[]
required

Payload containers with resolved data points and computed material contents.

​
data_points
object[]
required

Delivery-level resolved 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-DEL-N001016013"

​
display_key
string | null

Human-readable display identifier.

Example:

"GC-DEL-N001016013"

​
sent_at
string<date-time> | null

When the delivery was sent. UTC.

Example:

"2026-05-01T13:00:00Z"