Premium¶

TEBHOS has three paid products, all sold through Polar (see Billing):

• TEBHOS Pro — a personal subscription (monthly or yearly). Pro members show a blue badge and get Pro perks, including 10 free guild boosts in total.
• Guild boosts — raise a guild's boost level. Each boost lasts 30 days.
• Business Class (İş Sınıfı) — a per-guild subscription bought by the guild owner. The guild gets a yellow badge and level 2 boost perks, and its owner gets Pro perks.

The cosmetics shop is covered at the end of this page. Gifts covers gift codes.

Every route on this page requires a user session; bot tokens are rejected with 403 ACCESS_DENIED.

Premium types¶

Premium is active when the type is 3, or when the type is 1 or 2 and premiumUntil is in the future. The owner of a guild with an active Business Class subscription is reported as premium (type 1, Monthly) until that subscription ends, even without a Pro subscription.

Premium status object¶

Returned by Get my premium status and by Cancel premium. Field names use camelCase.

Example¶

{
  "premiumType": 1,
  "premiumTypeName": "Monthly",
  "isPremium": true,
  "premiumSince": "2026-09-01T10:00:00Z",
  "premiumUntil": "2026-10-01T10:00:00Z",
  "daysRemaining": 8,
  "premiumDays": 30,
  "premiumWillCancel": false,
  "has_billing_account": true
}

Get my premium status¶

GET /premium/me

Returns the caller's premium status object, plus:

Get premium state¶

GET /premium/state

Returns the caller's premium state in a nested {actual, effective, billing, pricing} shape. Only a few fields carry TEBHOS data:

Check users' badges¶

POST /premium/check

Resolves which of the given users show a premium (blue) or Business Class (yellow) badge, and their affiliation badges. Any authenticated user can call it.

JSON body¶

Response¶

{
  "premium_ids": ["1501314428688998182"],
  "business_ids": [],
  "affiliation_badges": []
}

Guild boosts¶

A guild's boost level comes from the number of boosts currently counting toward it:

Level 2 is the highest level, and it is required for a guild to appear in Discovery. At most 25 boosts count toward a guild at the same time; additional boosts wait as pending and start their 30-day period when a slot frees up. Pending boosts still count for the booster's own badge tiers.

A guild with active Business Class has an effective level of at least 2.

TEBHOS Pro members have 10 free boosts in total (not per month). A boost that expires or is removed does not return a free boost. Boosts beyond the free allowance, and all boosts for non-Pro users, are paid through Polar at 49,99 TL (2,99 USD) each.

Get my boost status¶

GET /users/@me/boost-status

Returns the caller's boosting summary across all guilds (camelCase):

Get guild boosts¶

GET /servers/{guild_id}/boost

Returns the boost state of a guild. Reading it also promotes pending boosts into free slots.

Boost guild¶

POST /servers/{guild_id}/boost

Boosts a guild. Free boosts are applied immediately; any paid remainder is charged in one Polar checkout.

JSON body¶

The body is optional.

Response¶

When every requested boost was covered by free boosts, the route returns 201:

{
  "id": "1501314428688998190",
  "message": "...",
  "free": true,
  "applied": 1,
  "priceMinor": 0,
  "currency": "TRY",
  "freeBoostRemaining": 9
}

When payment is needed, it returns 200 with a checkout URL. The paid boosts are applied after Polar confirms the payment; the browser returns to the guild's boost page.

{
  "paymentRequired": true,
  "url": "https://checkout.example.com/polar_c_1a2b3c",
  "freeApplied": 3,
  "paidCount": 7,
  "priceMinor": 34993,
  "unitPriceMinor": 4999,
  "currency": "TRY",
  "freeBoostRemaining": 0
}

Applying boosts re-indexes the guild for Discovery and dispatches a Guild Update.

Remove my boosts¶

DELETE /servers/{guild_id}/boost

Removes all of the caller's boosts from the guild and returns {"message": "..."}. Free boosts used on them are not returned. The guild is re-indexed and a Guild Update is dispatched.

List boosters¶

GET /servers/{guild_id}/boost/boosters

Returns the guild's boosters, oldest first, grouped per user:

[
  {
    "profileId": "1501314428688998182",
    "name": "example",
    "imageUrl": "",
    "boostCount": 3,
    "boostedAt": "2026-09-01T10:00:00Z"
  }
]

Business Class¶

Business Class is a subscription attached to one guild and bought by its owner through Create Business Class checkout. While it is active:

• the guild has the BUSINESS_CLASS guild feature and shows a yellow badge,
• the guild gets level 2 boost perks (its effective boost level is at least 2),
• the owner is treated as a TEBHOS Pro member,
• the owner can link up to 25 members to the guild with affiliations,
• anyone can join the guild through Join discovery guild.

Owner-only routes answer 404 NOT_FOUND to anyone who is not the guild owner, so they do not reveal whether the guild exists.

Business Class subscription object¶

Get my Business Class overview¶

GET /business/me

Lists every guild the caller owns with its Business Class state:

{
  "guilds": [
    {
      "guild_id": "1489002177550843904",
      "name": "Example guild",
      "icon_hash": null,
      "business": null,
      "business_active": false
    }
  ],
  "has_live": false
}

business is a subscription object or null.

Get guild Business Class¶

GET /business/guilds/{guild_id}

Owner only. Returns {"business": <subscription object or null>, "business_active": <bool>}.

Set Business Class discovery listing¶

PUT /business/guilds/{guild_id}/discovery

Owner only. Body {"enabled": true} or {"enabled": false}. Returns {"discovery_opt_in": <bool>}. The subscription alone does not list the guild; this opt-in is required.

List Business Class guilds¶

GET /business/discovery

Returns the live Business Class guilds that opted in to discovery:

Business Class affiliations¶

An affiliation links a guild member to a Business Class guild; the member can then show the guild's logo next to their name. The owner sends a request, and the member accepts or declines.

Affiliation statuses are pending, accepted and inactive. A guild can hold at most 25 affiliations that are not inactive. Sending a request is limited to 30 per hour per user (business:affiliate bucket).

Shop¶

The shop sells profile cosmetics. Purchases go through a Polar checkout; an item is added to the inventory after payment.

Cosmetic slots¶

List shop collections¶

GET /shop/collections

Returns {collections, items, bundles}. Items have id, slug, collection_id, name, description, item_type (a slot), price, premium_price, asset_data and purchasable; bundles have id, slug, collection_id, name, description, price, premium_price, item_ids and purchasable. purchasable is false when the item has no Polar product configured.

Get inventory¶

GET /shop/inventory

Returns {"entries": [{id, item_id, source, bundle_id, purchased_at}]} for the caller.

Get equipped cosmetics¶

GET /shop/equipped

Returns the caller's equipped item per slot as {name_plate, avatar_decoration, profile_effect, avatar_hat, app_logo} (each an item or null). POST /shop/equipped/bulk with {"profile_ids": [...]} returns the same for several users, keyed by user ID.

Purchase shop item¶

POST /shop/items/{item_id}/purchase

Opens a Polar checkout for one item and returns a redirect URL object.

Returns 400 when the buyer (or the gift recipient) already owns the item, when the recipient is the caller, or when the item cannot be purchased; 404 when the item or recipient does not exist.

Purchase shop bundle¶

POST /shop/bundles/{bundle_id}/purchase

Same as Purchase shop item for a bundle.

Equip a cosmetic¶

PATCH /shop/equipped/{slot}

Body {"item_id": "<item uuid>"} equips an item in the slot; {"item_id": null} clears the slot. The item type must match the slot. The caller must own the item, except for Pro-only items, which require TEBHOS Pro (or a gifted copy). Returns the caller's equipped cosmetics.

Cosmetic gifts¶

GET /shop/cosmetic-gifts lists unclaimed cosmetic gifts sent to the caller as {"gifts": [{id, sender_id, item_type, item_id, message}]}. POST /shop/cosmetic-gifts/claim claims them and returns 204.