BizKitHub
DocsAPI ReferenceAdmin/bff/admin/organisation-ai-spend
getAdminAdmin BFF

/bff/admin/organisation-ai-spend

Returns per-model breakdown and rolling-window totals (lifetime + last 1/7/30/365 days) of AI prompts stored in ai__question for the given organisation. Pricing uses the ai__model_price SCD table matched by prompt date, with margin_multiplier applied so super-admin sees the BizKitHub-side cost rather than the raw provider cost the customer sees in their own /settings/ai. A CZK envelope is included at today's USD→CZK fixing. Requires internal admin membership.

AdmingetBffAdminOrganisation-ai-spend

Parameters

1 query

Query parameters

· 1
slugstringRequired

Organisation slug to look up.

Exampleacme-corp

Response schema

1 status code documented

200Success
organisationobjectRequired
idnumberRequired
slugstringRequired
namestringRequired
windowsobjectRequired
lifetimeobjectRequired
tokensnumberRequired
costUsdnumberRequired
costCzknumberRequired
countnumberRequired
dayobjectRequired
tokensnumberRequired
costUsdnumberRequired
costCzknumberRequired
countnumberRequired
weekobjectRequired
tokensnumberRequired
costUsdnumberRequired
costCzknumberRequired
countnumberRequired
monthobjectRequired
tokensnumberRequired
costUsdnumberRequired
costCzknumberRequired
countnumberRequired
yearobjectRequired
tokensnumberRequired
costUsdnumberRequired
costCzknumberRequired
countnumberRequired
byModelobject[]Required
Each array item:
modelstringRequired

Model identifier (e.g. gemini-2.5-flash).

promptsMonthnumberRequired
tokensMonthnumberRequired
inputTokensMonthnumberRequired
outputTokensMonthnumberRequired
costUsdMonthnumberRequired
costCzkMonthnumberRequired
promptsLifetimenumberRequired
tokensLifetimenumberRequired
costUsdLifetimenumberRequired
costCzkLifetimenumberRequired
fxobjectRequired
code"CZK"Required
ratenumberRequired

USD → CZK multiplier at today's fixing.

rateDatestringRequired

YYYY-MM-DD of the underlying fixing.

Response example

application/json
{
  "organisation": {
    "id": 0,
    "slug": "example_slug",
    "name": "example_name"
  },
  "windows": {
    "lifetime": {
      "tokens": 0,
      "costUsd": 0,
      "costCzk": 0,
      "count": 0
    },
    "day": {
      "tokens": 0,
      "costUsd": 0,
      "costCzk": 0,
      "count": 0
    },
    "week": {
      "tokens": 0,
      "costUsd": 0,
      "costCzk": 0,
      "count": 0
    },
    "month": {
      "tokens": 0,
      "costUsd": 0,
      "costCzk": 0,
      "count": 0
    },
    "year": {
      "tokens": 0,
      "costUsd": 0,
      "costCzk": 0,
      "count": 0
    }
  },
  "byModel": [
    {
      "model": "example_model",
      "promptsMonth": 0,
      "tokensMonth": 0,
      "inputTokensMonth": 0,
      "outputTokensMonth": 0,
      "costUsdMonth": 0,
      "costCzkMonth": 0,
      "promptsLifetime": 0,
      "tokensLifetime": 0,
      "costUsdLifetime": 0,
      "costCzkLifetime": 0
    }
  ],
  "fx": {
    "code": "CZK",
    "rate": 0,
    "rateDate": "example_rateDate"
  }
}

Request example

GET /bff/admin/organisation-ai-spend

get
curl -X GET "https://api.bizkithub.com/bff/admin/organisation-ai-spend?slug=acme-corp" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key