Create a delivery

curl --request POST \
  --url https://api.demo.cula.earth/tracking/v1/deliveries \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Cula-Organisation-Id: <cula-organisation-id>' \
  --data '
{
  "config_id": "dlvc_01kkygy9cxxqhhr93aw74aycbr",
  "status": "finished",
  "occurred_at": "2026-01-15T08:00:00Z",
  "external_id": "MY-CUSTOM-ID",
  "legs": [
    {
      "sender_site": {
        "id": "ste_01k8g7aec6dt5zrtamc72ww446"
      },
      "receiver_site": {
        "id": "ste_01k8g7aec6dt5zrtamc72ww446"
      }
    }
  ],
  "payload_containers": [
    {
      "config_id": "mcnc_01k102qfrwthwk6dsggr9y8evn",
      "data_points": [
        {
          "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
          "value": "<string>",
          "input_value": "<string>"
        }
      ]
    }
  ],
  "payload": {
    "data_points": [
      {
        "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
        "value": "<string>",
        "input_value": "<string>"
      }
    ]
  },
  "data_points": [
    {
      "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
      "value": "<string>",
      "input_value": "<string>"
    }
  ]
}
'

import requests

url = "https://api.demo.cula.earth/tracking/v1/deliveries"

payload = {
    "config_id": "dlvc_01kkygy9cxxqhhr93aw74aycbr",
    "status": "finished",
    "occurred_at": "2026-01-15T08:00:00Z",
    "external_id": "MY-CUSTOM-ID",
    "legs": [
        {
            "sender_site": { "id": "ste_01k8g7aec6dt5zrtamc72ww446" },
            "receiver_site": { "id": "ste_01k8g7aec6dt5zrtamc72ww446" }
        }
    ],
    "payload_containers": [
        {
            "config_id": "mcnc_01k102qfrwthwk6dsggr9y8evn",
            "data_points": [
                {
                    "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
                    "value": "<string>",
                    "input_value": "<string>"
                }
            ]
        }
    ],
    "payload": { "data_points": [
            {
                "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
                "value": "<string>",
                "input_value": "<string>"
            }
        ] },
    "data_points": [
        {
            "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
            "value": "<string>",
            "input_value": "<string>"
        }
    ]
}
headers = {
    "Cula-Organisation-Id": "<cula-organisation-id>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Cula-Organisation-Id': '<cula-organisation-id>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    config_id: 'dlvc_01kkygy9cxxqhhr93aw74aycbr',
    status: 'finished',
    occurred_at: '2026-01-15T08:00:00Z',
    external_id: 'MY-CUSTOM-ID',
    legs: [
      {
        sender_site: {id: 'ste_01k8g7aec6dt5zrtamc72ww446'},
        receiver_site: {id: 'ste_01k8g7aec6dt5zrtamc72ww446'}
      }
    ],
    payload_containers: [
      {
        config_id: 'mcnc_01k102qfrwthwk6dsggr9y8evn',
        data_points: [
          {
            config_id: 'dptc_01jxdp05c8r7dp4xf89pxcw28q',
            value: '<string>',
            input_value: '<string>'
          }
        ]
      }
    ],
    payload: {
      data_points: [
        {
          config_id: 'dptc_01jxdp05c8r7dp4xf89pxcw28q',
          value: '<string>',
          input_value: '<string>'
        }
      ]
    },
    data_points: [
      {
        config_id: 'dptc_01jxdp05c8r7dp4xf89pxcw28q',
        value: '<string>',
        input_value: '<string>'
      }
    ]
  })
};

fetch('https://api.demo.cula.earth/tracking/v1/deliveries', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.demo.cula.earth/tracking/v1/deliveries",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'config_id' => 'dlvc_01kkygy9cxxqhhr93aw74aycbr',
    'status' => 'finished',
    'occurred_at' => '2026-01-15T08:00:00Z',
    'external_id' => 'MY-CUSTOM-ID',
    'legs' => [
        [
                'sender_site' => [
                                'id' => 'ste_01k8g7aec6dt5zrtamc72ww446'
                ],
                'receiver_site' => [
                                'id' => 'ste_01k8g7aec6dt5zrtamc72ww446'
                ]
        ]
    ],
    'payload_containers' => [
        [
                'config_id' => 'mcnc_01k102qfrwthwk6dsggr9y8evn',
                'data_points' => [
                                [
                                                                'config_id' => 'dptc_01jxdp05c8r7dp4xf89pxcw28q',
                                                                'value' => '<string>',
                                                                'input_value' => '<string>'
                                ]
                ]
        ]
    ],
    'payload' => [
        'data_points' => [
                [
                                'config_id' => 'dptc_01jxdp05c8r7dp4xf89pxcw28q',
                                'value' => '<string>',
                                'input_value' => '<string>'
                ]
        ]
    ],
    'data_points' => [
        [
                'config_id' => 'dptc_01jxdp05c8r7dp4xf89pxcw28q',
                'value' => '<string>',
                'input_value' => '<string>'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Cula-Organisation-Id: <cula-organisation-id>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.demo.cula.earth/tracking/v1/deliveries"

	payload := strings.NewReader("{\n  \"config_id\": \"dlvc_01kkygy9cxxqhhr93aw74aycbr\",\n  \"status\": \"finished\",\n  \"occurred_at\": \"2026-01-15T08:00:00Z\",\n  \"external_id\": \"MY-CUSTOM-ID\",\n  \"legs\": [\n    {\n      \"sender_site\": {\n        \"id\": \"ste_01k8g7aec6dt5zrtamc72ww446\"\n      },\n      \"receiver_site\": {\n        \"id\": \"ste_01k8g7aec6dt5zrtamc72ww446\"\n      }\n    }\n  ],\n  \"payload_containers\": [\n    {\n      \"config_id\": \"mcnc_01k102qfrwthwk6dsggr9y8evn\",\n      \"data_points\": [\n        {\n          \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n          \"value\": \"<string>\",\n          \"input_value\": \"<string>\"\n        }\n      ]\n    }\n  ],\n  \"payload\": {\n    \"data_points\": [\n      {\n        \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n        \"value\": \"<string>\",\n        \"input_value\": \"<string>\"\n      }\n    ]\n  },\n  \"data_points\": [\n    {\n      \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n      \"value\": \"<string>\",\n      \"input_value\": \"<string>\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Cula-Organisation-Id", "<cula-organisation-id>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.demo.cula.earth/tracking/v1/deliveries")
  .header("Cula-Organisation-Id", "<cula-organisation-id>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"config_id\": \"dlvc_01kkygy9cxxqhhr93aw74aycbr\",\n  \"status\": \"finished\",\n  \"occurred_at\": \"2026-01-15T08:00:00Z\",\n  \"external_id\": \"MY-CUSTOM-ID\",\n  \"legs\": [\n    {\n      \"sender_site\": {\n        \"id\": \"ste_01k8g7aec6dt5zrtamc72ww446\"\n      },\n      \"receiver_site\": {\n        \"id\": \"ste_01k8g7aec6dt5zrtamc72ww446\"\n      }\n    }\n  ],\n  \"payload_containers\": [\n    {\n      \"config_id\": \"mcnc_01k102qfrwthwk6dsggr9y8evn\",\n      \"data_points\": [\n        {\n          \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n          \"value\": \"<string>\",\n          \"input_value\": \"<string>\"\n        }\n      ]\n    }\n  ],\n  \"payload\": {\n    \"data_points\": [\n      {\n        \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n        \"value\": \"<string>\",\n        \"input_value\": \"<string>\"\n      }\n    ]\n  },\n  \"data_points\": [\n    {\n      \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n      \"value\": \"<string>\",\n      \"input_value\": \"<string>\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.demo.cula.earth/tracking/v1/deliveries")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Cula-Organisation-Id"] = '<cula-organisation-id>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"config_id\": \"dlvc_01kkygy9cxxqhhr93aw74aycbr\",\n  \"status\": \"finished\",\n  \"occurred_at\": \"2026-01-15T08:00:00Z\",\n  \"external_id\": \"MY-CUSTOM-ID\",\n  \"legs\": [\n    {\n      \"sender_site\": {\n        \"id\": \"ste_01k8g7aec6dt5zrtamc72ww446\"\n      },\n      \"receiver_site\": {\n        \"id\": \"ste_01k8g7aec6dt5zrtamc72ww446\"\n      }\n    }\n  ],\n  \"payload_containers\": [\n    {\n      \"config_id\": \"mcnc_01k102qfrwthwk6dsggr9y8evn\",\n      \"data_points\": [\n        {\n          \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n          \"value\": \"<string>\",\n          \"input_value\": \"<string>\"\n        }\n      ]\n    }\n  ],\n  \"payload\": {\n    \"data_points\": [\n      {\n        \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n        \"value\": \"<string>\",\n        \"input_value\": \"<string>\"\n      }\n    ]\n  },\n  \"data_points\": [\n    {\n      \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n      \"value\": \"<string>\",\n      \"input_value\": \"<string>\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "id": "dlv_01k204p7hghzdtwjb3n48s5fs5",
  "config_id": "dlvc_01kkygy9cxxqhhr93aw74aycbr",
  "config_version_id": "dlvcv_01kkw6g3ayad6f092rbkbjcaxq",
  "external_id": "MY-CUSTOM-ID",
  "display_id": "D-148",
  "status": "finished",
  "site": {
    "id": "ste_01k8g7aec6dt5zrtamc72ww446",
    "external_id": "SITE-EXT-0001"
  },
  "legs": [
    {
      "id": "dll_01kjjkhkr6azkf10qx8te8ztv6",
      "sender_site": {
        "id": "ste_01k8g7aec6dt5zrtamc72ww446",
        "external_id": "SITE-EXT-0001"
      },
      "receiver_site": {
        "id": "ste_01k8g7aec6dt5zrtamc72ww446",
        "external_id": "SITE-EXT-0001"
      }
    }
  ],
  "occurred_at": "2026-01-15T08:00:00Z",
  "created_at": "2026-01-15T08:00:00Z",
  "data_points": [
    {
      "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
      "config_version_id": "dptcv_01kfxe6xgmw15gsf204jwj90g5",
      "name": "Weight gross",
      "error": null,
      "type": "short_text",
      "value": "<string>",
      "input_value": "<string>",
      "result_value": "<string>"
    }
  ],
  "payload_containers": [
    {
      "id": "mcn_01kqz4g5cjzvwsnnps6q7183q3",
      "config_id": "mcnc_01k102qfrwthwk6dsggr9y8evn",
      "config_version_id": "mcncv_01kxs8mt2y4711mz04rqs14t0a",
      "status": "available",
      "data_points": [
        {
          "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
          "config_version_id": "dptcv_01kfxe6xgmw15gsf204jwj90g5",
          "name": "Weight gross",
          "error": null,
          "type": "short_text",
          "value": "<string>",
          "input_value": "<string>",
          "result_value": "<string>"
        }
      ]
    }
  ],
  "payload": [
    {
      "data_points": [
        {
          "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
          "config_version_id": "dptcv_01kfxe6xgmw15gsf204jwj90g5",
          "name": "Weight gross",
          "error": null,
          "type": "short_text",
          "value": "<string>",
          "input_value": "<string>",
          "result_value": "<string>"
        }
      ]
    }
  ],
  "files": [
    {
      "id": "fle_01kw9grq4tecva35wdpstzcj5z",
      "external_id": "MY-CUSTOM-ID",
      "name": "weighing-slip.pdf"
    }
  ]
}

{
  "code": "bad_request",
  "message": "The field limit must not be greater than 50."
}

{
  "code": "unauthorized",
  "message": "Invalid or expired token"
}

{
  "code": "conflict",
  "message": "There exists already an object with external ID MY-CUSTOM-ID within this organisation."
}

{
  "code": "too_many_requests",
  "message": "Too many requests. Try again after the time given in the Retry-After header."
}

{
  "code": "internal_server_error",
  "message": "Internal server error."
}

{
  "code": "bad_request",
  "message": "The field limit must not be greater than 50."
}

{
  "code": "service_unavailable",
  "message": "Machine data could not be read for data point config(s): dptc_01jxdp05c8r7dp4xf89pxcw28q. This is temporary; retry the request."
}

POST

deliveries

Create a delivery

curl --request POST \
  --url https://api.demo.cula.earth/tracking/v1/deliveries \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Cula-Organisation-Id: <cula-organisation-id>' \
  --data '
{
  "config_id": "dlvc_01kkygy9cxxqhhr93aw74aycbr",
  "status": "finished",
  "occurred_at": "2026-01-15T08:00:00Z",
  "external_id": "MY-CUSTOM-ID",
  "legs": [
    {
      "sender_site": {
        "id": "ste_01k8g7aec6dt5zrtamc72ww446"
      },
      "receiver_site": {
        "id": "ste_01k8g7aec6dt5zrtamc72ww446"
      }
    }
  ],
  "payload_containers": [
    {
      "config_id": "mcnc_01k102qfrwthwk6dsggr9y8evn",
      "data_points": [
        {
          "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
          "value": "<string>",
          "input_value": "<string>"
        }
      ]
    }
  ],
  "payload": {
    "data_points": [
      {
        "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
        "value": "<string>",
        "input_value": "<string>"
      }
    ]
  },
  "data_points": [
    {
      "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
      "value": "<string>",
      "input_value": "<string>"
    }
  ]
}
'

import requests

url = "https://api.demo.cula.earth/tracking/v1/deliveries"

payload = {
    "config_id": "dlvc_01kkygy9cxxqhhr93aw74aycbr",
    "status": "finished",
    "occurred_at": "2026-01-15T08:00:00Z",
    "external_id": "MY-CUSTOM-ID",
    "legs": [
        {
            "sender_site": { "id": "ste_01k8g7aec6dt5zrtamc72ww446" },
            "receiver_site": { "id": "ste_01k8g7aec6dt5zrtamc72ww446" }
        }
    ],
    "payload_containers": [
        {
            "config_id": "mcnc_01k102qfrwthwk6dsggr9y8evn",
            "data_points": [
                {
                    "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
                    "value": "<string>",
                    "input_value": "<string>"
                }
            ]
        }
    ],
    "payload": { "data_points": [
            {
                "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
                "value": "<string>",
                "input_value": "<string>"
            }
        ] },
    "data_points": [
        {
            "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
            "value": "<string>",
            "input_value": "<string>"
        }
    ]
}
headers = {
    "Cula-Organisation-Id": "<cula-organisation-id>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Cula-Organisation-Id': '<cula-organisation-id>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    config_id: 'dlvc_01kkygy9cxxqhhr93aw74aycbr',
    status: 'finished',
    occurred_at: '2026-01-15T08:00:00Z',
    external_id: 'MY-CUSTOM-ID',
    legs: [
      {
        sender_site: {id: 'ste_01k8g7aec6dt5zrtamc72ww446'},
        receiver_site: {id: 'ste_01k8g7aec6dt5zrtamc72ww446'}
      }
    ],
    payload_containers: [
      {
        config_id: 'mcnc_01k102qfrwthwk6dsggr9y8evn',
        data_points: [
          {
            config_id: 'dptc_01jxdp05c8r7dp4xf89pxcw28q',
            value: '<string>',
            input_value: '<string>'
          }
        ]
      }
    ],
    payload: {
      data_points: [
        {
          config_id: 'dptc_01jxdp05c8r7dp4xf89pxcw28q',
          value: '<string>',
          input_value: '<string>'
        }
      ]
    },
    data_points: [
      {
        config_id: 'dptc_01jxdp05c8r7dp4xf89pxcw28q',
        value: '<string>',
        input_value: '<string>'
      }
    ]
  })
};

fetch('https://api.demo.cula.earth/tracking/v1/deliveries', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.demo.cula.earth/tracking/v1/deliveries",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'config_id' => 'dlvc_01kkygy9cxxqhhr93aw74aycbr',
    'status' => 'finished',
    'occurred_at' => '2026-01-15T08:00:00Z',
    'external_id' => 'MY-CUSTOM-ID',
    'legs' => [
        [
                'sender_site' => [
                                'id' => 'ste_01k8g7aec6dt5zrtamc72ww446'
                ],
                'receiver_site' => [
                                'id' => 'ste_01k8g7aec6dt5zrtamc72ww446'
                ]
        ]
    ],
    'payload_containers' => [
        [
                'config_id' => 'mcnc_01k102qfrwthwk6dsggr9y8evn',
                'data_points' => [
                                [
                                                                'config_id' => 'dptc_01jxdp05c8r7dp4xf89pxcw28q',
                                                                'value' => '<string>',
                                                                'input_value' => '<string>'
                                ]
                ]
        ]
    ],
    'payload' => [
        'data_points' => [
                [
                                'config_id' => 'dptc_01jxdp05c8r7dp4xf89pxcw28q',
                                'value' => '<string>',
                                'input_value' => '<string>'
                ]
        ]
    ],
    'data_points' => [
        [
                'config_id' => 'dptc_01jxdp05c8r7dp4xf89pxcw28q',
                'value' => '<string>',
                'input_value' => '<string>'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Cula-Organisation-Id: <cula-organisation-id>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.demo.cula.earth/tracking/v1/deliveries"

	payload := strings.NewReader("{\n  \"config_id\": \"dlvc_01kkygy9cxxqhhr93aw74aycbr\",\n  \"status\": \"finished\",\n  \"occurred_at\": \"2026-01-15T08:00:00Z\",\n  \"external_id\": \"MY-CUSTOM-ID\",\n  \"legs\": [\n    {\n      \"sender_site\": {\n        \"id\": \"ste_01k8g7aec6dt5zrtamc72ww446\"\n      },\n      \"receiver_site\": {\n        \"id\": \"ste_01k8g7aec6dt5zrtamc72ww446\"\n      }\n    }\n  ],\n  \"payload_containers\": [\n    {\n      \"config_id\": \"mcnc_01k102qfrwthwk6dsggr9y8evn\",\n      \"data_points\": [\n        {\n          \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n          \"value\": \"<string>\",\n          \"input_value\": \"<string>\"\n        }\n      ]\n    }\n  ],\n  \"payload\": {\n    \"data_points\": [\n      {\n        \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n        \"value\": \"<string>\",\n        \"input_value\": \"<string>\"\n      }\n    ]\n  },\n  \"data_points\": [\n    {\n      \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n      \"value\": \"<string>\",\n      \"input_value\": \"<string>\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Cula-Organisation-Id", "<cula-organisation-id>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.demo.cula.earth/tracking/v1/deliveries")
  .header("Cula-Organisation-Id", "<cula-organisation-id>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"config_id\": \"dlvc_01kkygy9cxxqhhr93aw74aycbr\",\n  \"status\": \"finished\",\n  \"occurred_at\": \"2026-01-15T08:00:00Z\",\n  \"external_id\": \"MY-CUSTOM-ID\",\n  \"legs\": [\n    {\n      \"sender_site\": {\n        \"id\": \"ste_01k8g7aec6dt5zrtamc72ww446\"\n      },\n      \"receiver_site\": {\n        \"id\": \"ste_01k8g7aec6dt5zrtamc72ww446\"\n      }\n    }\n  ],\n  \"payload_containers\": [\n    {\n      \"config_id\": \"mcnc_01k102qfrwthwk6dsggr9y8evn\",\n      \"data_points\": [\n        {\n          \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n          \"value\": \"<string>\",\n          \"input_value\": \"<string>\"\n        }\n      ]\n    }\n  ],\n  \"payload\": {\n    \"data_points\": [\n      {\n        \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n        \"value\": \"<string>\",\n        \"input_value\": \"<string>\"\n      }\n    ]\n  },\n  \"data_points\": [\n    {\n      \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n      \"value\": \"<string>\",\n      \"input_value\": \"<string>\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.demo.cula.earth/tracking/v1/deliveries")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Cula-Organisation-Id"] = '<cula-organisation-id>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"config_id\": \"dlvc_01kkygy9cxxqhhr93aw74aycbr\",\n  \"status\": \"finished\",\n  \"occurred_at\": \"2026-01-15T08:00:00Z\",\n  \"external_id\": \"MY-CUSTOM-ID\",\n  \"legs\": [\n    {\n      \"sender_site\": {\n        \"id\": \"ste_01k8g7aec6dt5zrtamc72ww446\"\n      },\n      \"receiver_site\": {\n        \"id\": \"ste_01k8g7aec6dt5zrtamc72ww446\"\n      }\n    }\n  ],\n  \"payload_containers\": [\n    {\n      \"config_id\": \"mcnc_01k102qfrwthwk6dsggr9y8evn\",\n      \"data_points\": [\n        {\n          \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n          \"value\": \"<string>\",\n          \"input_value\": \"<string>\"\n        }\n      ]\n    }\n  ],\n  \"payload\": {\n    \"data_points\": [\n      {\n        \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n        \"value\": \"<string>\",\n        \"input_value\": \"<string>\"\n      }\n    ]\n  },\n  \"data_points\": [\n    {\n      \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n      \"value\": \"<string>\",\n      \"input_value\": \"<string>\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "id": "dlv_01k204p7hghzdtwjb3n48s5fs5",
  "config_id": "dlvc_01kkygy9cxxqhhr93aw74aycbr",
  "config_version_id": "dlvcv_01kkw6g3ayad6f092rbkbjcaxq",
  "external_id": "MY-CUSTOM-ID",
  "display_id": "D-148",
  "status": "finished",
  "site": {
    "id": "ste_01k8g7aec6dt5zrtamc72ww446",
    "external_id": "SITE-EXT-0001"
  },
  "legs": [
    {
      "id": "dll_01kjjkhkr6azkf10qx8te8ztv6",
      "sender_site": {
        "id": "ste_01k8g7aec6dt5zrtamc72ww446",
        "external_id": "SITE-EXT-0001"
      },
      "receiver_site": {
        "id": "ste_01k8g7aec6dt5zrtamc72ww446",
        "external_id": "SITE-EXT-0001"
      }
    }
  ],
  "occurred_at": "2026-01-15T08:00:00Z",
  "created_at": "2026-01-15T08:00:00Z",
  "data_points": [
    {
      "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
      "config_version_id": "dptcv_01kfxe6xgmw15gsf204jwj90g5",
      "name": "Weight gross",
      "error": null,
      "type": "short_text",
      "value": "<string>",
      "input_value": "<string>",
      "result_value": "<string>"
    }
  ],
  "payload_containers": [
    {
      "id": "mcn_01kqz4g5cjzvwsnnps6q7183q3",
      "config_id": "mcnc_01k102qfrwthwk6dsggr9y8evn",
      "config_version_id": "mcncv_01kxs8mt2y4711mz04rqs14t0a",
      "status": "available",
      "data_points": [
        {
          "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
          "config_version_id": "dptcv_01kfxe6xgmw15gsf204jwj90g5",
          "name": "Weight gross",
          "error": null,
          "type": "short_text",
          "value": "<string>",
          "input_value": "<string>",
          "result_value": "<string>"
        }
      ]
    }
  ],
  "payload": [
    {
      "data_points": [
        {
          "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
          "config_version_id": "dptcv_01kfxe6xgmw15gsf204jwj90g5",
          "name": "Weight gross",
          "error": null,
          "type": "short_text",
          "value": "<string>",
          "input_value": "<string>",
          "result_value": "<string>"
        }
      ]
    }
  ],
  "files": [
    {
      "id": "fle_01kw9grq4tecva35wdpstzcj5z",
      "external_id": "MY-CUSTOM-ID",
      "name": "weighing-slip.pdf"
    }
  ]
}

{
  "code": "bad_request",
  "message": "The field limit must not be greater than 50."
}

{
  "code": "unauthorized",
  "message": "Invalid or expired token"
}

{
  "code": "conflict",
  "message": "There exists already an object with external ID MY-CUSTOM-ID within this organisation."
}

{
  "code": "too_many_requests",
  "message": "Too many requests. Try again after the time given in the Retry-After header."
}

{
  "code": "internal_server_error",
  "message": "Internal server error."
}

{
  "code": "bad_request",
  "message": "The field limit must not be greater than 50."
}

{
  "code": "service_unavailable",
  "message": "Machine data could not be read for data point config(s): dptc_01jxdp05c8r7dp4xf89pxcw28q. This is temporary; retry the request."
}

Authorizations

Authorization

string

header

required

OAuth 2.0 client credentials. Exchange your client_id and client_secret for an access token scoped to the organisation that provides data access.

Headers

Cula-Organisation-Id

string

required

ID of the organisation the request operates on behalf of (e.g. org_...). Must be an organisation the API client has access to.

Example:

"org_01k83mfmhgchya944v86ryvhpq"

Body

application/json

config_id

string

required

The ID of the delivery config that defines the delivery to create.

Example:

"dlvc_01kkygy9cxxqhhr93aw74aycbr"

status

enum<string>

default:finished

Whether to create the delivery as an editable draft or as a finished delivery. Drafts may still be incomplete: mandatory data point values, the payload, and legs or their sites can be omitted and added later.

Available options:

draft,

finished

occurred_at

string<date-time>

When the delivery took place: an ISO 8601 date-time with an explicit UTC offset (Z or ±hh:mm). Defaults to now if omitted.

Example:

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

external_id

string

An optional custom ID that can be set to an internal ID from your system. This ID must be unique within all objects of the organisation you operate in. You can later use this external ID to reference and query this object. Be aware that you can update this ID later. If you need an immutable ID, use the object ID returned when creating the object.

Required string length: 1 - 100

Pattern: ^[A-Za-z0-9\-_]+$

Example:

"MY-CUSTOM-ID"

legs

object[]

The transport legs of the delivery, in order. For incoming configs, the last leg must be received by the config's site; for outgoing configs, the first leg must be sent by the config's site. Required for finished deliveries.

Required array length: 1 element

Show child attributes

payload_containers

(New Container · object | Existing Container · object)[]

If the config version's payload_configs field contains items, you can pass containers that reference a listed config and should be used as payload here. Several items may name the same config.

Maximum array length: 100

Describes a new container to create, based on one of the container configs listed by the config of the object you create.

New Container
Existing Container

Show child attributes

payload

object

deprecated

Deprecated: use data_points or payload_containers instead.

Show child attributes

data_points

object[]

Data points to be set on the delivery, based on the data_point_configs list of the delivery config. Included values might affect payload containers.

Maximum array length: 100

Show child attributes

Response

Delivery created.

string

required

The ID of the delivery.

Example:

"dlv_01k204p7hghzdtwjb3n48s5fs5"

config_id

string

required

The ID of the delivery config the delivery was created from.

Example:

"dlvc_01kkygy9cxxqhhr93aw74aycbr"

config_version_id

string

required

The ID of the exact delivery config version the delivery was created from.

Example:

"dlvcv_01kkw6g3ayad6f092rbkbjcaxq"

external_id

string | null

required

Optional external ID of the delivery.

Example:

"MY-CUSTOM-ID"

display_id

string

required

Human-readable, server-generated identifier scoped to the issuing site.

Example:

"D-148"

status

enum<string>

required

Lifecycle status. draft deliveries are still being prepared and may be missing data point values, payload or leg sites; finished deliveries are complete.

Available options:

draft,

finished

Example:

"finished"

site

object

required

The site that issued the delivery (owns its config).

Show child attributes

legs

object[]

required

The transport legs of the delivery, in order.

Show child attributes

occurred_at

string<date-time>

required

When the delivery took place.

Example:

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

created_at

string<date-time>

required

When the delivery was recorded in Cula.

Example:

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

data_points

required

Data points set on the delivery itself.

Data point holding a single line of text.

Show child attributes

payload_containers

object[]

required

The material containers carried by the delivery.

Show child attributes

payload

object[]

required

deprecated

Deprecated: use payload_containers instead.

Show child attributes

files

object[]

required

Files attached to the delivery. Lists only the files your organisation can access: a counterparty of the delivery does not see the files you attached, and vice versa.

Show child attributes

General

Material Tracking

Machine Data

Create a delivery

Authorizations

Headers

Body

Response