BizKitHub
DocsAPI ReferenceVendor/bff/vendor/managed-organisations
getVendorAdmin BFF

/bff/vendor/managed-organisations

Returns all organisations whose parent_id points to an organisation in which the calling user is an active member — i.e. the orgs the user can manage as a technical manager / vendor support. Includes the tariff, billing snapshot, paid-until status, member count, and a hasDirectMembership flag indicating whether the user is already a direct member of each row (so the UI can decide between a "Switch" button and a "Join + switch" button).

VendorgetBffVendorManaged-organisations

Parameters

No parameters required

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

Response schema

1 status code documented

200Success
organisationsobject[]Required
Each array item:
vendorobjectRequired
idnumberRequired
slugstringRequired
namestringRequired
emojistring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
organisationobjectRequired
idnumberRequired
slugstringRequired

Use this with POST /vendor/switch.

namestringRequired
emojistring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
insertedDatestringRequired
memberCountnumberRequired

Active members in the customer org.

storageUsedMbnumberRequired

Storage usage of the customer org, in MB.

tariffobjectRequired
idnumberRequired
codestringRequired
monthlyPriceCzknumberRequired

Catalogue price in CZK.

priceFrombooleanRequired

True for Enterprise (variable pricing).

billingobjectRequired
customPriceCzknumber | nullRequired

Negotiated price in CZK. NULL = use catalogue minus discount.

One of 2:
Variant 1
number
Variant 2
null
effectivePriceCzknumberRequired

Final monthly price the customer actually pays, in CZK.

discountPercentnumberRequired
paidUntilstring | nullRequired

Subscription expiry date.

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

Negative when expired. NULL when paidUntil is unset.

One of 2:
Variant 1
number
Variant 2
null
isExpiredbooleanRequired
expiringSoonbooleanRequired

True when daysUntilExpiry ≤ 14 and not yet expired.

hasDirectMembershipbooleanRequired

True if the calling user already has a cas__organisation_member row in this customer org. When false, POST /vendor/switch will auto-create one before switching.

totalsobjectRequired
countnumberRequired

Total managed organisations.

monthlyRevenueCzknumberRequired

Sum of effective monthly prices, in CZK.

expirednumberRequired

How many are past their paidUntil.

expiringSoonnumberRequired

How many are within 14 days of expiry.

Response example

application/json
{
  "organisations": [
    {
      "vendor": {
        "id": 0,
        "slug": "example_slug",
        "name": "example_name"
      },
      "organisation": {
        "id": 0,
        "slug": "example_slug",
        "name": "example_name",
        "insertedDate": "example_insertedDate",
        "memberCount": 0,
        "storageUsedMb": 0
      },
      "tariff": {
        "id": 0,
        "code": "example_code",
        "monthlyPriceCzk": 0,
        "priceFrom": false
      },
      "billing": {
        "effectivePriceCzk": 0,
        "discountPercent": 0,
        "isExpired": false,
        "expiringSoon": false
      },
      "hasDirectMembership": false
    }
  ],
  "totals": {
    "count": 0,
    "monthlyRevenueCzk": 0,
    "expired": 0,
    "expiringSoon": 0
  }
}

Request example

GET /bff/vendor/managed-organisations

get
curl -X GET "https://api.bizkithub.com/bff/vendor/managed-organisations" \
  -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