Get a material batch
Authorizations
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
ID of the organisation the request operates on behalf of (e.g. org_...). Must be an organisation the API client has access to.
"org_01k83mfmhgchya944v86ryvhpq"
Path Parameters
"mbt_01kjpyrpv5ffa8d2kqmgcqf2r6"
Response
Material batch with its files and data points.
Unique identifier of the material batch.
"mbt_01kjpyrpv5ffa8d2kqmgcqf2r6"
Human-readable identifier, unique per site.
"ba-de-146-1-1"
The site that owns the batch.
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.
draft, locked, submitted "locked"
The batch config the batch was created from.
"mbtc_01kdpna98wj3apgan3j36w499h"
Config version the batch was created with.
"mbtcv_01kgqrbj1xy7xebdf9easfa0wp"
Time the batch was created.
"2026-05-06T19:34:00Z"
The one material this batch describes; fixed at creation.
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
Files attached to the batch.
Data points recorded on the batch.
Data point holding a single line of text.
- short_text
- long_text
- multi_text
- number
- percentage
- amount
- timestamp
- duration
- boolean
- material
- material_batch
- container_type
- material_pool