> ## Documentation Index > Fetch the complete documentation index at: https://docs.cula.tech/llms.txt > Use this file to discover all available pages before exploring further. # List material batches ## OpenAPI ````yaml /openapi.json get /material-batches openapi: 3.1.0 info: title: Cula Tracking API version: 0.3.10 servers: - url: https://api.demo.cula.earth/tracking/v1 security: [] tags: - name: Organisations description: '' - name: Sites description: '' - name: Machines description: '' - name: Machine Variables description: '' - name: Machine Data Imports description: '' - name: Delivery Configs description: '' - name: Deliveries description: '' - name: Material Sourcing Configs description: '' - name: Material Sourcings description: '' - name: Material Conversion Configs description: '' - name: Material Conversions description: '' - name: Material Utilization Configs description: '' - name: Material Utilizations description: '' - name: Material Batches description: '' - name: Material Pools description: '' - name: Material Containers description: '' - name: Sinks description: '' - name: Documents description: '' - name: Webhooks description: '' paths: /material-batches: get: tags: - Material Batches summary: List material batches parameters: - name: Cula-Organisation-Id in: header description: >- ID of the organisation the request operates on behalf of (e.g. `org_...`). Must be an organisation the API client has access to. required: true schema: type: string example: org_01k83mfmhgchya944v86ryvhpq - name: limit required: false in: query description: Maximum number of items to return. schema: minimum: 1 maximum: 50 default: 10 type: integer - name: starting_after required: false in: query description: >- Cursor representing the item ID after which to start listing results. schema: type: string responses: '200': description: Material batches visible to the access token scope. content: application/json: schema: $ref: '#/components/schemas/ListMaterialBatchesResponse' '400': description: Invalid request payload or parameters. content: application/json: schema: $ref: '#/components/schemas/Error' example: code: bad_request message: The field limit must not be greater than 100. '401': description: Missing or invalid access token. content: application/json: schema: $ref: '#/components/schemas/Error' example: code: unauthorized message: Invalid or expired token '500': description: Unexpected server error. content: application/json: schema: $ref: '#/components/schemas/Error' example: code: internal_server_error message: Internal server error. security: - AccessToken: [] components: schemas: ListMaterialBatchesResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/MaterialBatchResponse' pagination: $ref: '#/components/schemas/Pagination' required: - data - pagination Error: type: object properties: code: type: string example: bad_request message: type: string example: The field limit must not be greater than 100. required: - code - message MaterialBatchResponse: type: object properties: id: type: string example: mbt_01kjpyrpv5ffa8d2kqmgcqf2r6 description: Unique identifier of the material batch. display_id: type: string description: Human-readable identifier, unique per site. example: ba-de-146-1-1 site: description: The site that owns the batch. allOf: - $ref: '#/components/schemas/SiteReference' status: description: >- 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. example: locked allOf: - $ref: '#/components/schemas/MaterialBatchStatus' config_id: type: string example: mbtc_01kdpna98wj3apgan3j36w499h description: The batch config the batch was created from. config_version_id: type: string example: mbtcv_01kgqrbj1xy7xebdf9easfa0wp description: Config version the batch was created with. created_at: type: string format: date-time example: '2026-05-06T19:34:00Z' description: Time the batch was created. material: description: The one material this batch describes; fixed at creation. allOf: - $ref: '#/components/schemas/MaterialReference' validity_period: oneOf: - $ref: '#/components/schemas/DayValidityPeriod' title: day_based - $ref: '#/components/schemas/TimeValidityPeriod' title: time_based nullable: true description: >- 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. required: - id - display_id - site - status - config_id - config_version_id - created_at - material - validity_period Pagination: type: object properties: starting_after: type: string nullable: true description: >- Cursor that was used to retrieve this page. Null implies the first page. example: null limit: type: integer minimum: 1 maximum: 50 description: Maximum number of items returned in this response. example: 10 has_more: type: boolean description: >- Indicates whether more items can be fetched when using the returned next_cursor. example: false next_cursor: type: string nullable: true description: >- Cursor to use as starting_after to fetch the next set of results. Null means no more results. example: null required: - starting_after - limit - has_more - next_cursor SiteReference: type: object properties: id: type: string nullable: true example: ste_01k8g7aec6dt5zrtamc72ww446 external_id: type: string nullable: true example: SITE-EXT-0001 description: >- References a site by its ID and the external ID you assigned to it (if any). required: - id - external_id MaterialBatchStatus: type: string enum: - draft - locked - submitted description: >- 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. MaterialReference: type: object properties: id: type: string example: mat_01kh0fwkq4x8p5ea34dr6e4v2e description: Unique identifier of the material. description: References a material by its ID. required: - id DayValidityPeriod: type: object properties: start_day: type: string description: >- First day of the period as an ISO 8601 calendar date (`2026-05-01`, RFC 3339 `full-date`) in the site's local timezone. example: '2026-05-01' end_day: type: string nullable: true description: >- Exclusive end day, formatted like `start_day`. Null while the batch is still open-ended. Immutable once set. example: '2026-06-01' description: >- The period a batch of a day-based config is valid for — whole calendar days in the site's local timezone, start inclusive, end exclusive; consecutive batches share the boundary value. required: - start_day - end_day TimeValidityPeriod: type: object properties: start_time: type: string description: >- Start of the period as a UTC ISO 8601 timestamp (RFC 3339 `date-time`) truncated to the minute — seconds and milliseconds are always zero. example: '2026-05-01T12:30:00.000Z' end_time: type: string nullable: true description: >- Exclusive end instant, formatted like `start_time`. Null while the batch is still open-ended. Immutable once set. example: '2026-06-01T08:00:00.000Z' description: >- The period a batch of a time-based config is valid for — exact instants truncated to the minute, start inclusive, end exclusive; consecutive batches share the boundary value. required: - start_time - end_time securitySchemes: AccessToken: type: oauth2 flows: clientCredentials: tokenUrl: https://auth.demo.cula.earth/oauth2/token scopes: {} description: >- OAuth 2.0 client credentials. Exchange your client_id and client_secret for an access token scoped to the organisation that provides data access. ````