Skip to main content
GET
Get a material utilization

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

id
string
required
Example:

"mut_01kcwnf3gxeezez5jxrhf1k34x"

Response

id
string
required

The ID of the material utilization.

Example:

"mut_01kcwnf3gxeezez5jxrhf1k34x"

config_id
string
required

The ID of the config the utilization was created from.

Example:

"mutc_01k16bap2kcz0asd2h2dkzz1xj"

config_version_id
string
required

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

Example:

"mutcv_01kbr6p08518pexf6rs9segz8j"

external_id
string | null
required

Optional external ID of the utilization.

Example:

"MY-CUSTOM-ID"

display_id
string
required

Human-readable identifier.

Example:

"SNK-2026-01-15-1"

site
object
required

The site the material was applied at.

occurred_at
string<date-time>
required

When the utilization took place.

Example:

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

created_at
string<date-time>
required

When the utilization was recorded in Cula.

Example:

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

coordinates
object | null
required

The coordinates the material was applied at.

data_points
(short_text · object | long_text · object | multi_text · object | number · object | percentage · object | amount · object | timestamp · object | duration · object | boolean · object | material · object | material_batch · object | container_type · object | material_pool · object)[]
required

Data points set on the utilization step itself.

Data point holding a single line of text.

input_containers
object[]
required

The material containers the utilization consumed. Always returned, whether the config is unified or not.