Skip to main content

Premium Resource

Fluxer Premium (also called Visionary) unlocks additional features and customization options.

Premium Types

Premium User Object

Premium status is included in the User object:
premium_type
integer | null
Premium subscription type (0, 1, or 2)
premium_since
ISO8601 timestamp | null
When the user first became premium
premium_until
ISO8601 timestamp | null
When the premium subscription expires (null for lifetime)
premium_will_cancel
boolean
Whether the subscription will cancel at period end
premium_billing_cycle
string | null
Billing cycle: “monthly”, “yearly”, or “lifetime”
premium_lifetime_sequence
integer | null
Lifetime subscriber number (e.g., #1, #42)

Premium Features

Profile Customization

Messaging

Guilds

Client Features

Storage & History

Pricing

Monthly Subscription

  • $9.99/month (USD)
  • Billed monthly
  • Cancel anytime
  • Features active while subscribed

Yearly Subscription

  • $99.99/year (USD)
  • Save 17% vs monthly
  • Billed annually
  • Cancel anytime, active until year end

Lifetime

  • $299.99 (USD, one-time)
  • Never expires
  • All premium features forever
  • Exclusive lifetime badge
  • Serial number badge (#1, #42, etc.)

Premium Badges

Premium subscribers receive badges on their profile:

Visionary Badge

Displays your premium status with:
  • Premium icon
  • Subscription start date (optional)
  • Lifetime sequence number (for lifetime subscribers)

Badge Privacy

Control badge visibility:
premium_badge_hidden
boolean
Hide the premium badge entirely
premium_badge_timestamp_hidden
boolean
Hide the “Premium since” timestamp
premium_badge_sequence_hidden
boolean
Hide the lifetime sequence number

Guild Perks

Guilds owned by premium users automatically receive:

Emoji & Sticker Slots

  • Base: 50 emoji slots, 5 sticker slots
  • With Premium Owner: 75 emoji slots, 8 sticker slots
  • With VISIONARY Feature: Unlimited emoji and stickers

Upload Limits

  • Base: Members can upload 25MB files
  • With Premium Owner: Members can upload 50MB files

Customization

  • Animated Icon: Guild icon can be animated (GIF)
  • Banner: Set a guild banner image
  • Invite Splash: Custom splash screen for invites
  • Vanity URL: Custom invite link

Premium Onboarding

New premium subscribers see an onboarding flow explaining features:
premium_onboarding_dismissed_at
ISO8601 timestamp | null
When the user dismissed premium onboarding
Dismiss onboarding:
POST /api/v1/users/@me/premium/dismiss-onboarding

Free Trial

Fluxer occasionally offers free premium trials:
  • 7-day trial for new users
  • Full access to premium features
  • No credit card required
  • Auto-expires after trial period
  • Can only use trial once per account

Premium Gifting

Gift premium to other users:
  1. Purchase a gift subscription via Billing
  2. Receive a unique gift code
  3. Send the code to the recipient
  4. Recipient redeems code for premium time
Gift options:
  • 1 month premium
  • 1 year premium
  • Custom duration (via support)

Endpoints

Get Premium Status

GET /api/v1/users/@me
Premium details are included in the user object.

Get Premium Features

GET /api/v1/premium/features
Returns a list of premium features and their availability. Response:
{
  "features": [
    {
      "id": "global_emojis",
      "name": "Global Emojis",
      "description": "Use custom emojis from any guild",
      "available": true
    },
    {
      "id": "animated_avatar",
      "name": "Animated Avatar",
      "description": "Upload GIF avatars",
      "available": true
    }
  ],
  "has_premium": true,
  "premium_type": 1
}

Get Premium Perks for Guild

GET /api/v1/guilds/{guild_id}/premium
Check what premium perks are active for a guild. Response:
{
  "owner_has_premium": true,
  "emoji_limit": 75,
  "sticker_limit": 8,
  "upload_limit": 52428800,
  "features": [
    "ANIMATED_ICON",
    "BANNER"
  ]
}

Dismiss Premium Onboarding

POST /api/v1/users/@me/premium/dismiss-onboarding
Mark premium onboarding as completed.

Update Badge Settings

PATCH /api/v1/users/@me/settings
Update premium badge visibility.
premium_badge_hidden
boolean
Hide premium badge
premium_badge_timestamp_hidden
boolean
Hide premium since timestamp
premium_badge_sequence_hidden
boolean
Hide lifetime sequence number

Premium Expiration

When premium expires:
  • Premium features are disabled immediately
  • Custom discriminator may be reset (if in use)
  • Animated avatars/banners become static
  • Guild perks removed if no other premium owner
  • Upload size reduced to free tier limits
  • Message history access restricted

Premium Refunds

See Billing for refund policies.

Premium Support

Premium subscribers get:
  • Priority support queue
  • Faster response times (typically <24h)
  • Dedicated premium support channel
  • Direct line to development team
Contact premium support:
  • Email: [email protected]
  • In-app: Premium Support button in settings
  • Discord: #premium-support channel

Grandfathered Plans

Users who subscribed during early access or special promotions may have grandfathered pricing:
  • Locked-in lower rates
  • Maintains price as long as subscription remains active
  • Canceling forfeits grandfathered pricing
  • Billing - Manage subscriptions and payments
  • Users - User premium status fields
  • Guilds - Guild premium perks

Build docs developers (and LLMs) love