---
title: "Get Workloads"
method: GET
path: "/query/v2/workloads"
tags: ["QUERIES_V2"]
---

# Get Workloads

`GET /query/v2/workloads`

## Request

- Base URL: `https://api.myaltimate.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.myaltimate.com/query/v2/workloads`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Get workloads (notebook/streamlit) with optional filtering by type.

Applies RBAC team filtering: when a team is selected, only workloads
permitted for that user group are returned.

## Query parameters

- `workload_type` 'NOTEBOOK' | 'STREAMLIT' | 'STORED_PROCEDURE' | 'UNKNOWN'
- `page` integer: Page number
- `size` integer: Page size
- `sortAttribute` string, nullable
- `sortOrder` string, nullable
- `start_date` string, date-time
- `end_date` string, date-time
- `navigationSource` string, nullable

## Headers

- `x-tenant` string, required

## Response `200`

Successful Response

- PageWorkloadPageResponse
  - `items` WorkloadPageResponse[], required
    - `hash` string, required
    - `query_summary` string, required
    - `job_count` integer, required
    - `cost` number, required
    - `query_type` string, required
    - `bytes_scanned` number, required
    - `execution_time` number, required
    - `warehouse_names` string[], required
    - `database_names` string[], required
  - `total` integer, nullable, required
  - `page` integer, nullable, required
  - `size` integer, nullable, required
  - `pages` integer, nullable

## Other responses

- `400`: Not supported for public user
- `403`: Not supported for public user
- `422`: Validation Error

## Changes

- **2026-10-31** `727657ce54e9`: 2 breaking
  - for the `query` request parameter `end_date`, default value was changed from `2026-10-30T17:31:07.490555` to `2026-10-30T17:33:38.990725`
  - for the `query` request parameter `start_date`, default value was changed from `2026-10-02T17:31:07.490517` to `2026-10-02T17:33:38.990682`
- **2026-10-31** `6f0cdcf50d27`: 2 breaking
  - for the `query` request parameter `end_date`, default value was changed from `2026-10-30T17:31:07.662722` to `2026-10-30T17:31:07.490555`
  - for the `query` request parameter `start_date`, default value was changed from `2026-10-02T17:31:07.662685` to `2026-10-02T17:31:07.490517`
- **2026-10-31** `53882d07cc69`: 2 breaking
  - for the `query` request parameter `end_date`, default value was changed from `2026-10-30T17:31:07.741517` to `2026-10-30T17:31:07.662722`
  - for the `query` request parameter `start_date`, default value was changed from `2026-10-02T17:31:07.741479` to `2026-10-02T17:31:07.662685`
- **2026-10-31** `5f7fb68ade7a`: 2 breaking
  - for the `query` request parameter `end_date`, default value was changed from `2026-10-30T17:31:07.589159` to `2026-10-30T17:31:07.741517`
  - for the `query` request parameter `start_date`, default value was changed from `2026-10-02T17:31:07.589121` to `2026-10-02T17:31:07.741479`
- …earlier changes not shown

[Operation history](https://skmtc.dev/myaltimate/apis/myaltimate-api/changes/query/v2/workloads/get.md)

---

[API](https://skmtc.dev/myaltimate/apis/myaltimate-api.md) - [All operations](https://skmtc.dev/myaltimate/apis/myaltimate-api/llms.txt) - [OpenAPI document](https://skmtc.dev/myaltimate/apis/myaltimate-api/revisions/727657ce54e9?raw)