---
title: "Get Workspace Spend"
method: GET
path: "/v1/workspaces/spend"
tags: ["Workspaces"]
---

# Get Workspace Spend

`GET /v1/workspaces/spend`

Allocation versus actual, for the workspaces this caller can see.

The sibling above answers "how much of the plan is still unclaimed", which is what the
workspace form needs. This one answers the customer's question: for a workspace I belong
to, how much was set aside, how much has actually been spent this billing period, how
much is left, and which agents are spending it.

Visibility is exactly the visibility every list endpoint uses, so it follows the access
model rather than restating it: a member sees the workspaces they belong to, and an org
admin sees all of them. The organization roll-up is included only for a caller who can
already see every workspace, since it would otherwise describe spending in workspaces
they are not on.

## Query parameters

- `workspace_id` string, nullable

## Headers

- `X-API-Key` string, required

## Response `200`

Successful Response

- WorkspaceSpendResponse
  - `period_start` string, nullable
  - `credits_available` boolean
  - `minute_charges_configured` boolean, required
  - `org_limit_credits` number, nullable
  - `allocated_credits` number, required
  - `spent_credits` number, nullable
  - `organization` OrganizationSpendOut — The whole organization's burn, including what no workspace owns.
    - `minutes` number
    - `spent_credits` number, nullable
    - `unattributed_credits` number, nullable
  - `workspaces` WorkspaceSpendOut[]
    - `id` string, required
    - `name` string, required
    - `is_default` boolean, required
    - `allocated_credits` number, nullable
    - `minutes` number
    - `spent_credits` number, nullable
    - `remaining_credits` number, nullable
    - `agents` AgentSpendOut[]
      - `agent_id` string, required
      - `name` string, nullable
      - `minutes` number
      - `spent_credits` number, nullable
      - `simulation_credits` number, nullable
      - `observability_credits` number, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/getbluejay/apis/bluejay-api.md) · [All operations](https://skmtc.dev/getbluejay/apis/bluejay-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getbluejay/bluejay-api/revisions/bf69ab7268a4/schema)