---
title: "List workloads"
method: GET
path: "/v1/workloads"
tags: ["Workloads"]
---

# List workloads

`GET /v1/workloads`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/workloads`
- Auth: HTTP bearer

## Query parameters

- `limit` integer
- `offset` integer
- `status` string
- `scope` 'mine' | 'team'

## Response `200`

Success

- object
  - `workloads` WorkloadListItem[]
    - `id` string
    - `status` string
    - `spend_usd` number
    - `revision` integer
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `meter` Meter
      - `settled_usd` number
      - `accruing_usd` number
      - `accruing_rate_usd_hour` number
      - `total_now_usd` number
      - `as_of` string, date-time
      - `final_charge_usd` number: Immutable aggregate lifetime compute charge for a terminal workload. Present only after every customer usage clock is settled and complete initial compute cost coverage is available across the workload scope. This total is independent of the current billing month. Retaining files can continue to incur separate usage charges, which are excluded from this fixed compute total.
      - `charge_state` 'estimated' | 'final': Compute charge finality for workloads using metered pricing. Estimated means compute usage is still accruing, terminal usage is still settling, or required initial compute cost coverage is incomplete. Final means final_charge_usd is frozen. Retained-file usage can continue after compute is final. Historical workload contracts may omit this field.
      - `compute_settled_usd` number: Settled compute charges in this billing period.
      - `platform_fee_settled_usd` number: Settled platform fees in this billing period.
      - `subscription_settled_usd` number: Settled subscription charges in an account meter. Zero in workload meters.
      - `storage_settled_usd` number: Settled saved-file charges earned in this UTC billing month in an account meter. Already included in settled_usd. Zero in workload and workspace compute-session meters.
      - `model_settled_usd` number: Settled managed model charges in this billing period in an account meter. Already included in settled_usd. Zero in workload and workspace compute-session meters.
      - `shared_settled_usd` number: Settled shared service charges in this billing period in an account meter. Already included in settled_usd. Zero in workload and workspace compute-session meters.
      - `compute_accruing_usd` number: Compute charges accruing at as_of.
      - `platform_fee_accruing_usd` number: Platform fees accruing at as_of.
    - `owner_user_id` string, nullable: Member who submitted the workload. Null for historical or unattributed submissions. Attribution is assigned by the server.
    - `name` string: Optional display name for the run, saved across sessions. Control characters are not allowed.
    - `links` WorkloadLink[]: Run links captured from live output, available before completion.
      - `kind` 'wandb', required
      - `url` string, uri, required: Validated HTTPS wandb run URL for the admitted entity and project.
  - `next_offset` integer

## Other responses

- `default`: Error. The JSON error and message fields are stable. Additional fields may provide details. Authentication, rate limits, and transient failures apply to all operations.

## Changes

- **2026-10-01** `5805e96227f4`: 1 info
  - added the optional property `workloads/items/meter/shared_settled_usd` to the response with the `200` status
- **2026-10-01** `ba84c74aeec8`: 3 info
  - added the optional property `workloads/items/meter/charge_state` to the response with the `200` status
  - added the optional property `workloads/items/meter/final_charge_usd` to the response with the `200` status
  - added the optional property `workloads/items/meter/model_settled_usd` to the response with the `200` status
- **2026-10-01** `544fef290a54`: 3 warning
  - removed the optional property `workloads/items/meter/charge_state` from the response with the `200` status
  - removed the optional property `workloads/items/meter/final_charge_usd` from the response with the `200` status
  - removed the optional property `workloads/items/meter/model_settled_usd` from the response with the `200` status
- **2026-09-27** `f73dea7ab0c4`: 2 info
  - added the optional property `workloads/items/meter/charge_state` to the response with the `200` status
  - added the optional property `workloads/items/meter/final_charge_usd` to the response with the `200` status
- **2026-09-27** `c27e8c7c4e1f`: 1 info
  - added the optional property `workloads/items/meter/model_settled_usd` to the response with the `200` status

[Operation history](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/changes/v1/workloads/get.md)

---

[API](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api.md) - [All operations](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/revisions/a59210899d95?raw)