Update a material batch

curl --request PATCH \
  --url https://api.demo.cula.earth/tracking/v1/material-batches/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Cula-Organisation-Id: <cula-organisation-id>' \
  --data '
{
  "display_id": "ba-de-146-1-1",
  "validity_period": {
    "end_day": "2026-06-01",
    "end_time": "2026-06-01T08:00:00Z"
  },
  "status": "locked",
  "data_points": [
    {
      "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
      "value": "<string>",
      "input_value": "<string>"
    }
  ]
}
'

import requests

url = "https://api.demo.cula.earth/tracking/v1/material-batches/{id}"

payload = {
    "display_id": "ba-de-146-1-1",
    "validity_period": {
        "end_day": "2026-06-01",
        "end_time": "2026-06-01T08:00:00Z"
    },
    "status": "locked",
    "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.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {
    'Cula-Organisation-Id': '<cula-organisation-id>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    display_id: 'ba-de-146-1-1',
    validity_period: {end_day: '2026-06-01', end_time: '2026-06-01T08:00:00Z'},
    status: 'locked',
    data_points: [
      {
        config_id: 'dptc_01jxdp05c8r7dp4xf89pxcw28q',
        value: '<string>',
        input_value: '<string>'
      }
    ]
  })
};

fetch('https://api.demo.cula.earth/tracking/v1/material-batches/{id}', 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/material-batches/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'display_id' => 'ba-de-146-1-1',
    'validity_period' => [
        'end_day' => '2026-06-01',
        'end_time' => '2026-06-01T08:00:00Z'
    ],
    'status' => 'locked',
    '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/material-batches/{id}"

	payload := strings.NewReader("{\n  \"display_id\": \"ba-de-146-1-1\",\n  \"validity_period\": {\n    \"end_day\": \"2026-06-01\",\n    \"end_time\": \"2026-06-01T08:00:00Z\"\n  },\n  \"status\": \"locked\",\n  \"data_points\": [\n    {\n      \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n      \"value\": \"<string>\",\n      \"input_value\": \"<string>\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("PATCH", 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.patch("https://api.demo.cula.earth/tracking/v1/material-batches/{id}")
  .header("Cula-Organisation-Id", "<cula-organisation-id>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"display_id\": \"ba-de-146-1-1\",\n  \"validity_period\": {\n    \"end_day\": \"2026-06-01\",\n    \"end_time\": \"2026-06-01T08:00:00Z\"\n  },\n  \"status\": \"locked\",\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/material-batches/{id}")

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

request = Net::HTTP::Patch.new(url)
request["Cula-Organisation-Id"] = '<cula-organisation-id>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"display_id\": \"ba-de-146-1-1\",\n  \"validity_period\": {\n    \"end_day\": \"2026-06-01\",\n    \"end_time\": \"2026-06-01T08:00:00Z\"\n  },\n  \"status\": \"locked\",\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": "mbt_01kjpyrpv5ffa8d2kqmgcqf2r6",
  "display_id": "ba-de-146-1-1",
  "site": {
    "id": "ste_01k8g7aec6dt5zrtamc72ww446",
    "external_id": "SITE-EXT-0001"
  },
  "status": "locked",
  "config_id": "mbtc_01kdpna98wj3apgan3j36w499h",
  "config_version_id": "mbtcv_01kgqrbj1xy7xebdf9easfa0wp",
  "created_at": "2026-05-06T19:34:00Z",
  "material": {
    "id": "mat_01kh0fwkq4x8p5ea34dr6e4v2e"
  },
  "validity_period": {
    "start_day": "2026-05-01",
    "end_day": "2026-06-01"
  },
  "files": [
    {
      "id": "fle_01kw9grq4tecva35wdpstzcj5z",
      "external_id": "MY-CUSTOM-ID",
      "name": "ebc-certificate.pdf"
    }
  ],
  "data_points": [
    {
      "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
      "config_version_id": "dptcv_01kfxe6xgmw15gsf204jwj90g5",
      "name": "Weight gross",
      "type": "short_text",
      "value": "<string>",
      "input_value": "<string>",
      "result_value": "<string>"
    }
  ]
}

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

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

{
  "code": "not_found",
  "message": "Resource with ID xyz_01k56g7aec6dt5zrtamc72vw446 could not be found."
}

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

PATCH

material-batches

{id}

Update a material batch

curl --request PATCH \
  --url https://api.demo.cula.earth/tracking/v1/material-batches/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Cula-Organisation-Id: <cula-organisation-id>' \
  --data '
{
  "display_id": "ba-de-146-1-1",
  "validity_period": {
    "end_day": "2026-06-01",
    "end_time": "2026-06-01T08:00:00Z"
  },
  "status": "locked",
  "data_points": [
    {
      "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
      "value": "<string>",
      "input_value": "<string>"
    }
  ]
}
'

import requests

url = "https://api.demo.cula.earth/tracking/v1/material-batches/{id}"

payload = {
    "display_id": "ba-de-146-1-1",
    "validity_period": {
        "end_day": "2026-06-01",
        "end_time": "2026-06-01T08:00:00Z"
    },
    "status": "locked",
    "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.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {
    'Cula-Organisation-Id': '<cula-organisation-id>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    display_id: 'ba-de-146-1-1',
    validity_period: {end_day: '2026-06-01', end_time: '2026-06-01T08:00:00Z'},
    status: 'locked',
    data_points: [
      {
        config_id: 'dptc_01jxdp05c8r7dp4xf89pxcw28q',
        value: '<string>',
        input_value: '<string>'
      }
    ]
  })
};

fetch('https://api.demo.cula.earth/tracking/v1/material-batches/{id}', 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/material-batches/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'display_id' => 'ba-de-146-1-1',
    'validity_period' => [
        'end_day' => '2026-06-01',
        'end_time' => '2026-06-01T08:00:00Z'
    ],
    'status' => 'locked',
    '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/material-batches/{id}"

	payload := strings.NewReader("{\n  \"display_id\": \"ba-de-146-1-1\",\n  \"validity_period\": {\n    \"end_day\": \"2026-06-01\",\n    \"end_time\": \"2026-06-01T08:00:00Z\"\n  },\n  \"status\": \"locked\",\n  \"data_points\": [\n    {\n      \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n      \"value\": \"<string>\",\n      \"input_value\": \"<string>\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("PATCH", 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.patch("https://api.demo.cula.earth/tracking/v1/material-batches/{id}")
  .header("Cula-Organisation-Id", "<cula-organisation-id>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"display_id\": \"ba-de-146-1-1\",\n  \"validity_period\": {\n    \"end_day\": \"2026-06-01\",\n    \"end_time\": \"2026-06-01T08:00:00Z\"\n  },\n  \"status\": \"locked\",\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/material-batches/{id}")

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

request = Net::HTTP::Patch.new(url)
request["Cula-Organisation-Id"] = '<cula-organisation-id>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"display_id\": \"ba-de-146-1-1\",\n  \"validity_period\": {\n    \"end_day\": \"2026-06-01\",\n    \"end_time\": \"2026-06-01T08:00:00Z\"\n  },\n  \"status\": \"locked\",\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": "mbt_01kjpyrpv5ffa8d2kqmgcqf2r6",
  "display_id": "ba-de-146-1-1",
  "site": {
    "id": "ste_01k8g7aec6dt5zrtamc72ww446",
    "external_id": "SITE-EXT-0001"
  },
  "status": "locked",
  "config_id": "mbtc_01kdpna98wj3apgan3j36w499h",
  "config_version_id": "mbtcv_01kgqrbj1xy7xebdf9easfa0wp",
  "created_at": "2026-05-06T19:34:00Z",
  "material": {
    "id": "mat_01kh0fwkq4x8p5ea34dr6e4v2e"
  },
  "validity_period": {
    "start_day": "2026-05-01",
    "end_day": "2026-06-01"
  },
  "files": [
    {
      "id": "fle_01kw9grq4tecva35wdpstzcj5z",
      "external_id": "MY-CUSTOM-ID",
      "name": "ebc-certificate.pdf"
    }
  ],
  "data_points": [
    {
      "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
      "config_version_id": "dptcv_01kfxe6xgmw15gsf204jwj90g5",
      "name": "Weight gross",
      "type": "short_text",
      "value": "<string>",
      "input_value": "<string>",
      "result_value": "<string>"
    }
  ]
}

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

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

{
  "code": "not_found",
  "message": "Resource with ID xyz_01k56g7aec6dt5zrtamc72vw446 could not be found."
}

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

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"

Path Parameters

string

required

Example:

"mbt_01kjpyrpv5ffa8d2kqmgcqf2r6"

Body

application/json

display_id

string

Human-readable identifier, e.g. an EBC batch ID; must be unique per site. Requires the batch to be a draft.

Maximum string length: 100

Example:

"ba-de-146-1-1"

validity_period

object

Sets the validity end of an open-ended batch. Requires the batch to be a draft.

Show child attributes

status

enum<string>

Target lifecycle status: locked locks a draft batch (rejected while requirements are still open), draft changes a locked batch back to an editable draft. Submitted batches are final and cannot be patched.

Available options:

draft,

locked

Example:

"locked"

data_points

object[]

Values for data points of the batch config. Partial: only the listed data points change. Requires the batch to be a draft.

Maximum array length: 100

Show child attributes

Response

The updated material batch.

string

required

Unique identifier of the material batch.

Example:

"mbt_01kjpyrpv5ffa8d2kqmgcqf2r6"

display_id

string

required

Human-readable identifier, unique per site.

Example:

"ba-de-146-1-1"

site

object

required

The site that owns the batch.

Show child attributes

status

enum<string>

required

Lifecycle status. draft batches are still editable, locked batches are read-only but can be changed back to draft, submitted batches have at least one submitted sink and are final.

Available options:

draft,

locked,

submitted

Example:

"locked"

config_id

string

required

The batch config the batch was created from.

Example:

"mbtc_01kdpna98wj3apgan3j36w499h"

config_version_id

string

required

Config version the batch was created with.

Example:

"mbtcv_01kgqrbj1xy7xebdf9easfa0wp"

created_at

string<date-time>

required

Time the batch was created.

Example:

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

material

object

required

The one material this batch describes; fixed at creation.

Show child attributes

validity_period

day_based · object

required

The variant follows the batch config: day-based configs return start_day/end_day, time-based configs start_time/end_time. Null if the config does not require a validity period.

day_based
time_based

Show child attributes

files

object[]

required

Files attached to the batch.

Show child attributes

data_points

required

Data points recorded on the batch.

Data point holding a single line of text.

Show child attributes

General

Material Tracking

Machine Data

Update a material batch

Authorizations

Headers

Path Parameters

Body

Response