---
title: "What the assistant has cost the organization"
method: GET
path: "/v3/backoffice/assistant/usage"
tags: ["AI Assistant"]
---

# What the assistant has cost the organization

`GET /v3/backoffice/assistant/usage`

## Request

- Base URL: `https://api.rhinoartisan.com`
- URL: `https://api.rhinoartisan.com/v3/backoffice/assistant/usage`
- Auth: API key in header `apikey`
- TypeScript: <https://skmtc.dev/rhinoartisan/apis/rhinoartisan-api/docs/v3/backoffice/assistant/usage/get.ts> (a function with typed inputs; its response is checked against the schema)

Dollars (OpenRouter usage.cost), user messages and tokens of the last 24 hours and the last 30 days, the 30 days split by surface (showroom, backoffice, settings, backstage, <module>/studio) and by model, and the daily budget (the organization's own or the platform default) with what is spent today.

## Response `200`

{today: {cost, messages, prompt_tokens, completion_tokens}, month: {…}, by_surface: [{surface, cost, messages}], by_model: [{model, cost, calls}], budget: {limit, spent_today, is_default}}

## Changes

- **2026-10-18** `8ae8fa399980`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rhinoartisan/apis/rhinoartisan-api/changes/v3/backoffice/assistant/usage/get.md)

---

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