---
title: "List candidate jobs for consumption recording"
method: GET
path: "/v1/filament-consumption/candidates"
tags: ["Filament Consumption", "Debug"]
---

# List candidate jobs for consumption recording

`GET /v1/filament-consumption/candidates`

Lists completed, failed, or cancelled print jobs that don't have filament consumption records yet. Useful for finding jobs to backfill. For users in multiple organizations, specify organizationId to select which organization's data to retrieve.

## Query parameters

- `organizationId` string, uuid
- `limit` number
- `status` 'COMPLETED' | 'FAILED' | 'CANCELLED'

## Response `200`

Default Response

- object
  - `data` object[]
    - `id` number
    - `name` unknown
    - `status` unknown
    - `progress` unknown
    - `model_file_id` unknown
    - `printer_id` unknown
    - `updated_at` unknown
  - `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/versions/3b06bcb5f808/schema)