BizKitHub
DocsAPI ReferenceAdmin/bff/admin/organisation-list
getAdminAdmin BFF

/bff/admin/organisation-list

Returns a paginated list of all organisations with active member counts. Supports fulltext search by name, slug, or description. Sorted by liveness — the latest member activity (MAX last_activity_date) descending, falling back to organisation inserted date, so active organisations float to the top and dormant ones sink. Each item carries an isMember flag indicating whether the calling admin has an active (non-blocked) membership in that organisation. Requires internal admin membership.

AdmingetBffAdminOrganisation-list

Parameters

No parameters required

This endpoint takes no path, query, header or body parameters.

Response schema

1 status code documented

200Success
itemsobject[]Required
Each array item:
namestringRequired

Organisation display name.

slugstringRequired

URL-friendly organisation identifier.

descriptionstring | nullRequired

Organisation description.

One of 2:
Variant 1
string
Variant 2
null
emojistring | nullRequired

Organisation emoji icon.

One of 2:
Variant 1
string
Variant 2
null
memberCountnumberRequired

Number of active (non-blocked) members.

contactCountnumberRequired

Number of contacts (shop__contact rows, excluding soft-deleted).

orderCountnumberRequired

Total number of orders (shop__order rows).

lastActivityAtstringRequired

Most recent member activity timestamp (ISO-8601). Falls back to the organisation inserted date when there has been no member activity yet. Drives the list ordering.

isMemberbooleanRequired

True when the calling admin is an active (non-blocked) member of this organisation.

tariffobject | nullRequired

Assigned tariff summary. NULL when no tariff row exists for the organisation.

One of 2:
Variant 1
codestringRequired

Tariff code from the catalogue (e.g. "free", "business").

effectivePriceCzknumberRequired

Effective monthly price in whole CZK. Custom override wins over the catalogue price minus discount.

activeTostring | nullRequired

Paid-until date (ISO-8601). NULL when the tariff has no expiry set.

One of 2:
Variant 1
string
Variant 2
null
Variant 2
null
aiSpendobjectRequired

Rollup of the organisation's AI usage in ai__question — lifetime and rolling 30-day windows. Uses per-token SCD pricing with margin.

tokensLifetimenumberRequired

Total AI tokens ever billed to this organisation (input + output combined).

tokensLast30dnumberRequired

AI tokens billed to this organisation in the last 30 days.

promptsLifetimenumberRequired

Total number of AI prompts stored for this organisation.

promptsLast30dnumberRequired

Number of AI prompts stored in the last 30 days.

costCzkLifetimenumberRequired

BizKitHub-side lifetime cost in CZK — per-token price from ai__model_price × margin_multiplier, converted USD→CZK at today's fixing.

costCzkLast30dnumberRequired

Cost in CZK for the last 30 days, same formula as costCzkLifetime.

itemCountnumberRequired

Total number of organisations matching the filter.

Response example

application/json
{
  "items": [
    {
      "name": "example_name",
      "slug": "example_slug",
      "memberCount": 0,
      "contactCount": 0,
      "orderCount": 0,
      "lastActivityAt": "example_lastActivityAt",
      "isMember": false,
      "aiSpend": {
        "tokensLifetime": 0,
        "tokensLast30d": 0,
        "promptsLifetime": 0,
        "promptsLast30d": 0,
        "costCzkLifetime": 0,
        "costCzkLast30d": 0
      }
    }
  ],
  "itemCount": 0
}

Request example

GET /bff/admin/organisation-list

get
curl -X GET "https://api.bizkithub.com/bff/admin/organisation-list" \
  -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