---
title: "List linked workspace usage"
method: GET
path: "/v1/organization/webapp/usage"
tags: ["Organization"]
---

# List linked workspace usage

`GET /v1/organization/webapp/usage`

List per-generation credit-usage rows for the linked Runway workspaces you administer, newest first. Unlike `/v1/organization/usage` (this API project's own usage), this reports usage from the workspace linked to this API project. Authorized via that account link.

## Query parameters

- `cursor` string
- `limit` integer, required
- `from` string, date-time, required
- `to` string, date-time, required
- `organizationId` string, uuid
- `workspaceIds` string

## Headers

- `X-Runway-Version` '2024-11-06', required

## Response `200`

Success

- object
  - `data` object[], required — The list of items for the current page.
    - `timestamp` string, date-time, required — When the generation was charged.
    - `email` string, required — Email of the user who generated.
    - `workspaceId` integer, required — ID of the owning workspace.
    - `workspaceName` string, required — Name of the owning workspace.
    - `tool` string, required — Model/task display name for the generation.
    - `credits` number, required — Credits charged for this generation.
    - `type` 'charge' | 'refund', required — Whether the row is a credit charge for a generation or a task refund (negative credits).
  - `hasMore` boolean, required — Whether there are more items available after this page.
  - `nextCursor` string, nullable, required — Cursor to use for fetching the next page, or null if there are no more pages.

---

[API](https://skmtc.net/runwayml/apis/runwayml-api.md) · [All operations](https://skmtc.net/runwayml/apis/runwayml-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/runwayml/runwayml-api/revisions/cbbe796a13a0/schema)