> ## 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 pools ## OpenAPI ````yaml /openapi.json get /material-pools 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-pools: get: tags: - Material Pools summary: List material pools 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: site_id required: false in: query description: Filter by the site owning the pool. schema: type: string - name: is_archived required: false in: query description: Filter by archived state. schema: type: boolean - 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 pools visible to the access token scope. content: application/json: schema: $ref: '#/components/schemas/ListMaterialPoolsResponse' '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: ListMaterialPoolsResponse: type: object properties: data: description: The current page of material pools. type: array items: $ref: '#/components/schemas/MaterialPoolResponse' pagination: description: Pagination metadata for the returned page. allOf: - $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 MaterialPoolResponse: type: object properties: id: type: string example: mpl_01k2xytkbr0pxazkxbj4j5gr0y description: Unique identifier of the material pool. external_id: type: string nullable: true example: POOL-EXT-0001 description: The external ID you assigned to this pool, if any. name: type: string nullable: true example: Woodchips pile north description: User-given name of the pool, if any. type: example: pile description: 'Physical form of the pool: a solid `pile` or a liquid `tank`.' allOf: - $ref: '#/components/schemas/MaterialPoolType' transaction_strategy: description: >- How mixed material is attributed to its sources during carbon accounting: `queue` consumes contributions oldest-first (FIFO), `stack` newest-first (LIFO). Fixed at creation. example: stack allOf: - $ref: '#/components/schemas/MaterialPoolTransactionStrategy' is_archived: type: boolean description: >- Archived pools are excluded from inventory views and are never auto-selected as a transaction target. example: false site: description: The site owning this pool. allOf: - $ref: '#/components/schemas/SiteReference' contents: description: Current per-material balances. type: array items: $ref: '#/components/schemas/MaterialPoolContent' created_at: type: string format: date-time example: '2025-10-10T21:03:58Z' description: Time the pool was created. required: - id - external_id - name - type - transaction_strategy - is_archived - site - contents - created_at 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 MaterialPoolType: type: string enum: - pile - tank description: 'Physical form of the pool: a solid `pile` or a liquid `tank`.' MaterialPoolTransactionStrategy: type: string enum: - queue - stack description: >- How mixed material is attributed to its sources during carbon accounting: `queue` consumes contributions oldest-first (FIFO), `stack` newest-first (LIFO). Fixed at creation. 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 MaterialPoolContent: type: object properties: material: description: The material this balance is for. allOf: - $ref: '#/components/schemas/MaterialReference' weight_in_kg: type: number description: >- Current balance in kilograms of dry matter. Can be negative when material was extracted before the corresponding addition was recorded. example: 600 description: Current balance of one material in the pool. required: - material - weight_in_kg 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 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. ````