---
title: "Get consumption summary by material"
method: GET
path: "/v1/filament-consumption/summary"
tags: ["Filament Consumption"]
---

# Get consumption summary by material

`GET /v1/filament-consumption/summary`

Returns aggregated filament consumption data grouped by material, with totals for grams/meters used and record counts by job status. For users in multiple organizations, specify organizationId to select which organization's data to retrieve.

## Query parameters

- `organizationId` string, uuid
- `start_date` string, date-time
- `end_date` string, date-time
- `printer_id` string, uuid
- `material_id` string, uuid

## Response `200`

Default Response

- object
  - `data` object[]
    - `material_id` unknown
    - `material_name` unknown
    - `material_brand` unknown
    - `material_color` unknown
    - `material_metadata` object
      - `colors` string[]
      - `gradient` boolean
      - `extrusion_type` string
      - `finish` string
      - `modifiers` string[]
      - `volumetric_flow` number
    - `total_usage_grams` number
    - `total_usage_meters` number
    - `total_expected_grams` number
    - `total_expected_meters` number
    - `record_count` number
    - `distinct_print_job_count` number
    - `completed_count` number
    - `failed_count` number
    - `cancelled_count` number
  - `totals` object
    - `distinct_print_job_count` number
    - `completed_count` number
    - `failed_count` number
    - `cancelled_count` 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/6ac11cc265be/schema)