---
title: "Get consumption history for a material"
method: GET
path: "/v1/materials/{id}/consumption"
tags: ["Filament Consumption", "Materials"]
---

# Get consumption history for a material

`GET /v1/materials/{id}/consumption`

Returns filament consumption records and summary for a specific material within the organization. For users in multiple organizations, specify organizationId to select which organization's data to retrieve.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `organizationId` string, uuid
- `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
  - `material` object
    - `id` string
    - `name` unknown
    - `brand` unknown
    - `color` unknown
  - `summary` object
    - `total_usage_grams` number
    - `total_usage_meters` number
    - `total_expected_grams` number
    - `total_expected_meters` number

## Other responses

- `404` — Default Response
- `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/3b06bcb5f808/schema)