---
title: "List filament consumption records"
method: GET
path: "/v1/filament-consumption"
tags: ["Filament Consumption"]
---

# List filament consumption records

`GET /v1/filament-consumption`

Lists filament consumption records for the organization with optional filters for material, printer, job, status, and date range. For users in multiple organizations, specify organizationId to select which organization's data to retrieve.

## Query parameters

- `organizationId` string, uuid
- `material_id` string, uuid
- `printer_id` string, uuid
- `print_job_id` number
- `job_status` 'COMPLETED' | 'FAILED' | 'CANCELLED'
- `start_date` string, date-time
- `end_date` string, date-time
- `limit` number
- `offset` number
- `page` number

## Response `200`

Default Response

- object
  - `data` object[]
    - `id` string
    - `material_id` unknown
    - `print_job_id` unknown
    - `printer_id` unknown
    - `organization_id` string
    - `usage_grams` unknown
    - `usage_meters` unknown
    - `expected_grams` unknown
    - `expected_meters` unknown
    - `job_status` string
    - `progress_at_end` unknown
    - `filament_index` number
    - `recorded_at` string
    - `created_at` string
  - `total` number

## Other responses

- `500` — Default Response

---

[API](https://skmtc.net/printhiv3d/apis/hive-api-documentation.md) · [All operations](https://skmtc.net/printhiv3d/apis/hive-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/printhiv3d/hive-api-documentation/revisions/6fe5e0368cb0/schema)