Skip to main content
GET
Get a material conversion

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:

"mcv_01k1k06s731c8dpsfc8beya4rt"

Response

id
string
required

The ID of the material conversion.

Example:

"mcv_01k1k06s731c8dpsfc8beya4rt"

config_id
string
required

The ID of the config the conversion was created from.

Example:

"mcvc_01kyaas94dty6shm2d0j7zw9v8"

config_version_id
string
required

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

Example:

"mcvcv_01krxsm2pxdgygx26jbyv4ztjy"

external_id
string | null
required

Optional external ID of the conversion.

Example:

"MY-CUSTOM-ID"

display_id
string
required

Human-readable identifier.

Example:

"PYR-2026-01-15-1"

site
object
required

The site the conversion was executed at.

occurred_at
string<date-time>
required

When the conversion took place.

Example:

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

created_at
string<date-time>
required

When the conversion was recorded in Cula.

Example:

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

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 conversion step itself.

Data point holding a single line of text.

input_containers
object[]
required

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

output_containers
object[]
required

The material containers the conversion produced. Always returned, whether the config is unified or not.