Skip to main content
Looking for the full API Reference? Visit api-docs.fnlb.net for our comprehensive interactive documentation.

​
🔗 Base URL

https://api.fnlb.net/v1 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/v1/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/v1/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);

​
Social & Friends

Manage your bot’s social interactions, including friends and blocked users.

​
GET /bots/:botId/friends

Returns a list of current friends for a specific bot. 
curl -X GET https://api.fnlb.net/v1/bots/BOT_ID/friends \
  -H "Authorization: YOUR_API_KEY"

​
GET /bots/:botId/users/blocked

Returns an array of users currently blocked by the bot.

​
Commands

Programmatically control your bots.

​
POST /bots/:botId/commands/run

Execute a specific command on a bot (e.g., set outfit, emote). Request Body: 
{
  "command": "outfit",
  "args": "Renegade Raider",
  "locale": "en"
}
Looking for the full API Reference? Visit api-docs.fnlb.net for our comprehensive interactive documentation.