> ## 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 batch configs



## OpenAPI

````yaml /openapi.json get /material-batch-configs
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-batch-configs:
    get:
      tags:
        - Material Batch Configs
      summary: List material batch configs
      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: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListMaterialBatchConfigsResponse'
        '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:
    ListMaterialBatchConfigsResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/MaterialBatchConfigSummary'
        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
    MaterialBatchConfigSummary:
      type: object
      properties:
        id:
          type: string
          example: mbtc_01kdpna98wj3apgan3j36w499h
          description: The ID of the batch config.
        site:
          description: The site that owns this config.
          allOf:
            - $ref: '#/components/schemas/SiteReference'
        validity_period_type:
          example: day_based
          description: >-
            How batches of this config track validity periods: `day_based`
            boundaries are calendar dates (`2026-05-01`), `time_based`
            boundaries are UTC timestamps truncated to the minute
            (`2026-05-01T12:30:00Z`), `none` batches carry no validity period.
          allOf:
            - $ref: '#/components/schemas/BatchValidityPeriodType'
        created_at:
          type: string
          format: date-time
          example: '2026-01-15T08:00:00Z'
          description: When this config was created.
        active_version:
          description: The currently active version of the batch config.
          allOf:
            - $ref: '#/components/schemas/MaterialBatchConfigVersionRef'
      required:
        - id
        - site
        - validity_period_type
        - created_at
        - active_version
    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
    BatchValidityPeriodType:
      type: string
      enum:
        - day_based
        - time_based
        - none
      description: >-
        How batches of this config track validity periods: `day_based`
        boundaries are calendar dates (`2026-05-01`), `time_based` boundaries
        are UTC timestamps truncated to the minute (`2026-05-01T12:30:00Z`),
        `none` batches carry no validity period.
    MaterialBatchConfigVersionRef:
      type: object
      properties:
        id:
          type: string
          example: mbtcv_01kgqrbj1xy7xebdf9easfa0wp
          description: The ID of the batch config version.
        name:
          type: string
          example: Biochar Production Batch
          description: Human-readable name of the batch config version.
      description: Reference to a batch config version.
      required:
        - id
        - name
  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.

````