BizKitHub
DocsAPI ReferenceOrganisation/bff/organisation-ai/usage/list
getOrganisationAdmin BFF

/bff/organisation-ai/usage/list

Paginated feed of ai__question rows scoped to the authenticated organisation. Each row carries the truncated prompt, model, tokens (total + input/output split), USD cost priced against the historical ai__model_price row effective on the prompt date, org-currency amount converted at that same date's FX rate, and the payer (this organisation vs. BizKitHub). Powers the AI usage grid in settings.

OrganisationgetBffOrganisation-aiUsageList

Parameters

2 query

Query parameters

· 2
pagestringOptional

Page number (1-based).

Example1
limitstringOptional

Max items per page (1–500, default 50).

Example50

Response schema

1 status code documented

200Success
itemsobject[]Required
Each array item:
idstringRequired

ai__question.id serialised as a decimal string (bigint safe).

questionstringRequired

Prompt text, truncated to 500 characters for grid display.

modelstringRequired

Model name from ai__model (e.g. "gemini-2.5-flash", "gpt-4o-mini").

tokensnumberRequired

Total tokens consumed (input + output).

inputTokensnumberRequired

Provider-reported input tokens.

outputTokensnumberRequired

Provider-reported output tokens.

costnumberRequired

Total USD cost priced against ai__model_price effective at the prompt date.

inputCostnumberRequired

USD cost attributable to input tokens.

outputCostnumberRequired

USD cost attributable to output tokens.

costOrgnumberRequired

Total cost converted to the organisation default currency at the prompt-date rate.

orgRatenumberRequired

USD → org currency multiplier applied for this row.

orgRateDatestringRequired

YYYY-MM-DD of the fixing behind orgRate.

payer"organisation" | "bizkit"Required

Who was billed for the underlying provider call: "organisation" via BYOK key, or "bizkit" via the shared BizKitHub key.

insertedDatestringRequired

ISO 8601 timestamp of when the answer was persisted.

itemCountnumberRequired
orgCurrencyobjectRequired
codestringRequired

ISO 4217 code of the organisation default currency (e.g. "CZK").

ratenumberRequired

Multiplier: usd × rate = amount in code.

rateDatestringRequired

YYYY-MM-DD of the underlying fixing.

Response example

application/json
{
  "items": [
    {
      "id": "example_id",
      "question": "example_question",
      "model": "example_model",
      "tokens": 0,
      "inputTokens": 0,
      "outputTokens": 0,
      "cost": 0,
      "inputCost": 0,
      "outputCost": 0,
      "costOrg": 0,
      "orgRate": 0,
      "orgRateDate": "example_orgRateDate",
      "insertedDate": "example_insertedDate"
    }
  ],
  "itemCount": 0,
  "orgCurrency": {
    "code": "example_code",
    "rate": 0,
    "rateDate": "example_rateDate"
  }
}

Request example

GET /bff/organisation-ai/usage/list

get
curl -X GET "https://api.bizkithub.com/bff/organisation-ai/usage/list?page=1&limit=50" \
  -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