We are working on providing more endpoints and documentation for FNLB’s API. Currently, the API is in a beta state and may change without notice as we develop FNLB. Please use the API at your own risk and report any issues you encounter.

🔗 Base URL

https://api.fnlb.net All endpoints are relative to this base URL.
All endpoints require a valid API key provided in the Authorization header using your FNLB API token. Learn more.

GET /bots

Returns a list of bots associated with the authenticated user.
const response = await fetch('https://api.fnlb.net/bots', {
  headers: {
    'Authorization': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
});
if (!response.ok) throw new Error('Error fetching bots ' + await response.text());

const bots = await response.json();
console.log('Bots:', bots);
Example Response
[
    {
        "parent": "7a85cbd3e019417e8b6fcd4e",
        "nickname": "Bot Lobby 1",
        "email": "botlobby1@gmail.com",
        "id": "78a43c92b18f45c92de74aa2"
    },
    {
        "parent": "7a85cbd3e019417e8b6fcd4e",
        "nickname": "Bot Lobby 2",
        "email": "elitegrindmatch34@gmail.com",
        "id": "78a43c92b18f45c92de74ab8"
    }
]

GET /categories

Returns a list of categories associated with the authenticated user.
const response = await fetch('https://api.fnlb.net/categories', {
  headers: {
    'Authorization': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
});
if (!response.ok) throw new Error('Error fetching categories ' + await response.text());

const categories = await response.json();
console.log('Categories:', categories);
Example Response
[
    {
        "id": "7a85cbd3e019417e8b6fcd4e",
        "name": "Test Category",
        "config": {
            "admins": [
                {
                    "id": "bb246024308e42b4b6cf46885da5393f",
                    "name": "tnfAngel"
                }
            ],
            "privacy": 1,
            "acceptInvites": true,
            "disablePlaylistChecks": true,
            "platform": [
                "SWT2"
            ],
            "inviteTimeout": 0,
            "level": [
                0
            ],
            "startOutfit": [
                {
                    "id": "CID_030_Athena_Commando_M_Halloween",
                    "variants": [
                        1,
                        44
                    ]
                },
                {
                    "id": "CID_029_Athena_Commando_F_Halloween",
                    "variants": [
                        2
                    ]
                },
                {
                    "id": "CID_434_Athena_Commando_F_StealthHonor",
                    "variants": []
                },
                {
                    "id": "CID_175_Athena_Commando_M_Celestial",
                    "variants": []
                }
            ],
            "prefixes": [
                "!",
                ".",
                "/"
            ]
        }
    }
]