API Documentation

Liberty Business gives your Discord bot or custom storefront a simple REST API to place and manage alt-launching orders. Your API key is available on the dashboard — treat it like a password.

Overview

The base URL for all API requests is:

https://libertyalts.com

All request and response bodies use JSON. All authenticated endpoints require a Bearer token in the Authorization header.

Authentication

Include your API key as a Bearer token on every request:

Authorization: Bearer YOUR_API_KEY

Your API key is shown on the API Key tab of the dashboard. Keep it secret — anyone with your key can place orders on your account.

Quick Start

Place your first order in under a minute:

curl -X POST https://libertyalts.com/api/v1/order \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "server_code": "ABC123",
    "num_alts": 5
  }'

Response:

{
  "order_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "launching",
  "num_alts": 5,
  "accounts_launched": 0,
  "server_code": "ABC123",
  "created_at": "2026-02-26T12:00:00+00:00"
}

Orders

Place an order

Get order status

Returns the current status, launch count, and verification stats for an order.

Get order events

Returns per-account status breakdown: which accounts are launched, confirmed in-game, or have left.

Cancel an order

Cancels an active order and terminates any accounts still in-game.

List all orders

Returns all orders for your business, most recent first.

Platform Status

Returns the number of workers online, total available accounts, and active orders for your business.

{
  "workers_online": 3,
  "total_accounts_available": 47,
  "active_orders": 1
}

Alters

List alters

Returns all approved alters for your business with their online status and account count.

Add alters

{ "discord_user_ids": ["123456789", "987654321"] }

Invite alters by Discord user ID. They must have the Liberty Business worker app installed and connect to your business to become active.

Remove an alter

Account

Returns your current business profile including plan, API key, and trial info.

Building a Discord Bot

You can integrate Liberty Business into your Discord server bot using the REST API. A typical order flow looks like this:

1. User runs /order with a server code and alt count
2. Bot calls POST /api/v1/order with your API key
3. Bot polls GET /api/v1/order/{id} every 10s and updates the embed
4. When done, bot confirms the session is active

# Example Python snippet (discord.py)
import httpx

API_KEY = "your_api_key_here"
BASE    = "https://libertyalts.com"

async def place_order(server_code: str, num_alts: int):
    async with httpx.AsyncClient() as client:
        res = await client.post(
            f"{BASE}/api/v1/order",
            headers={"Authorization": f"Bearer {API_KEY}"},
            json={"server_code": server_code, "num_alts": num_alts}
        )
        return res.json()

Order Modes

Standard

Alts join the server and stay until you cancel the order. Best for events or extended sessions.

Timed

Alts join for a fixed duration, then leave automatically. Set duration_minutes in the order request.

{
  "server_code": "ABC123",
  "num_alts": 10,
  "mode": "timed",
  "duration_minutes": 60
}

Keep-Full Premium+

Monitors the total player count on the server using the PRC API. Automatically adds alts when the count drops below 36 and cycles them out one at a time once the server reaches 39 players, keeping room for real players to join naturally.

PRC Player Verification

To enable in-game confirmation and dropout detection, pass the server owner's PRC API key with the order:

{
  "server_code": "ABC123",
  "num_alts": 5,
  "prc_server_key": "prc_xxxxxxxxxxxxxxxx"
}

The PRC key is provided by the end-client (server owner) and is used only to verify player presence. Liberty Business never stores it beyond the active order session.

With PRC verification enabled, you can track verified_count (confirmed in-game) and dropout_count (left early) on the order status endpoint.

Keep-Full Deep Dive

Keep-Full monitors the total server player count (not just your alts):

• Below 36 players → Liberty adds alts to bring the count back up
• At 39 players → Liberty cycles one alt out, waits 60 seconds, then repeats if still at 39

This keeps the server appearing popular to attract real players while leaving space for them to join. Alts that leave are recycled back into the available pool for future cycles.

Requires a valid prc_server_key in the order request and a Premium or Unlimited plan.