---
title: "Get Notebook Runtime User Costs"
method: GET
path: "/query/v2/notebooks/runtime/users"
tags: ["QUERIES_V2"]
---

# Get Notebook Runtime User Costs

`GET /query/v2/notebooks/runtime/users`

## 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/notebooks/runtime/users`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
- TypeScript: <https://skmtc.dev/myaltimate/apis/myaltimate-api/docs/query/v2/notebooks/runtime/users/get.ts> (a function with typed inputs; its response is checked against the schema)

Known runtime cost per source user, limited to missing notebook IDs.

## Query parameters

- `start_date` string, date-time, required
- `end_date` string, date-time, required
- `instance_id` integer, nullable
- `account` string, nullable
- `page` integer
- `size` integer
- `sortAttribute` 'cost' | 'credits' | 'user_name' | 'source_rows'
- `sortOrder` 'asc' | 'desc'
- `search` string, nullable
- `instance_ids` integer[], nullable
- `navigationSource` string, nullable

## Headers

- `x-tenant` string, required

## Response `200`

Successful Response

- NotebookRuntimeUserCosts
  - `status` 'available' | 'no_data' | 'restricted' | 'unavailable', required
  - `items` NotebookRuntimeUserCost[], required
    - `instance_id` integer, required
    - `account` string, required
    - `user_id` integer, nullable, required
    - `user_name` string, nullable, required
    - `source_rows` integer, required
    - `unknown_credit_rows` integer, required
    - `credits` number, nullable, required
    - `cost` number, nullable, required
    - `cost_currency` string, nullable
  - `total` integer, required
  - `page` integer, required
  - `size` integer, required
  - `pages` integer, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-10** `f1a58aabf8ae`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/myaltimate/apis/myaltimate-api/changes/query/v2/notebooks/runtime/users/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/8f8bb74ee1e3?raw)
