Skip to content
BranchesTags

Repository files navigation


Typing SVG




  The most complete Centralized REST API for Free Fire — Player Info, JWT Generator, Ban Check, Guild Tools, Friend Actions, Bind/Unbind, Wallet Info, Login History, Wish List, Outfit Renderer and more. 34 endpoints across 19 groups, all in one place.

🌐 Base URL & Authentication

Base URL:  http://siambhau69.eu.cc

  Every request requires a valid API Key. Keys are sold individually with per-endpoint access. Contact @SiamBhau to purchase.

Add the key query parameter to every request:

http://siambhau69.eu.cc/<group>/<endpoint>?param=VALUE&key=YOUR_KEY
🔐 Authentication Error Responses (HTTP 403) 
// Missing Key
{
  "error": "API key required. Use ?key=YOUR_KEY | Contact: t.me/SiamBhau"
}


// Invalid Key
{
  "error": "Invalid API key. | Contact: t.me/SiamBhau"
}


// Inactive Key
{
  "error": "Key is inactive. Contact admin. | Contact: t.me/SiamBhau"
}


// Expired Key
{
  "error": "Key expired on 30-06-2025. | Contact: t.me/SiamBhau"
}


// No Endpoint Access
{
  "error": "Key has no access to 'bancheck' endpoint. | Contact: t.me/SiamBhau"
}

📋 All API Groups

GET http://siambhau69.eu.cc/
📄 View Full Response (19 Groups) 
{
  "API": "Free Fire Centralized API System",
  "Version": "6.0",
  "Total API": 19,
  "Total Endpoints": 34,
  "Owner": "SiamBhau",
  "Telegram": "t.me/SiamBhau",
  "Groups": {
    "Access To JWT"  : "/accesstojwt",
    "Add Item"       : "/additem",
    "Ban Check"      : "/bancheck",
    "Bind Tools"     : "/bind",
    "Banner"         : "/banner",
    "Dynamic Duo"    : "/dynamicduo",
    "EAT To JWT"     : "/eattojwt",
    "Free Fire Info" : "/freefireinfo",       // ← FREE TIER ✨
    "Friends Tools"  : "/friends",
    "Guild Tools"    : "/guild",
    "JWT Decode"     : "/jwttokendecode",
    "JWT Generate"   : "/jwtgenerate",
    "Login History"  : "/loginhistory",
    "Long Bio"       : "/longbio",
    "Name Changer"   : "/namechanger",
    "Outfits"        : "/outfits",
    "Wallet Info"    : "/walletinfo",
    "Wish List"      : "/wish",
    "Craftlands"     : "/craftlands"
  }
}

1. 🔑 Access To JWT

 

Generates a Free Fire JWT Bearer Token from a Garena Access Token, UID/Password combo, or in bulk.

GET /accesstojwt/token — JWT Token Generate

▸ Method 1: Via Access Token

GET /accesstojwt/token?access_token=YOUR_ACCESS_TOKEN&key=YOUR_KEY
Parameter Type Required Description
access_token string ✅ Garena OAuth Access Token
key string ✅ Your API Key

▸ Method 2: Via UID + Password

GET /accesstojwt/token?uid=4147917569&password=8415C426BBE3371DADD82F5B&key=YOUR_KEY
Parameter Type Required Description
uid string ✅ Free Fire Guest UID
password string ✅ Account Password (hex format)
key string ✅ Your API Key
✅ Success / ❌ Error Responses 
// Access-Token Method
{
  "success": true,
  "region": "BD",
  "status": "1",
  "BearerAuth": "eyJhbGciOiJSUzI1NiIs...",
  "uid": "2579249340",
  "open_id": "abc123def456",
  "platform_type": 4
}


// UID+Password Method
{
  "region": "BD",
  "status": "1",
  "token": "eyJ...JWT...",
  "token_access": "eyJ...AccessToken...",
  "uid": "4147917569"
}


// Errors
{
  "success": false,
  "error": "INVALID_TOKEN",
  "message": "AccessToken invalid."
}

{
  "success": false,
  "error": "INVALID_PLATFORM",
  "message": "Account registered on another platform"
}

{
  "uid": "4147917569",
  "error": "Failed to retrieve token"
}

GET /accesstojwt/get_jwt — Return JWT Only

GET /accesstojwt/get_jwt?access_token=YOUR_ACCESS_TOKEN&key=YOUR_KEY
GET /accesstojwt/get_jwt?guest_uid=UID&guest_password=PASSWORD&key=YOUR_KEY
Parameter Type Required Description
access_token string ⚡ Garena Access Token
guest_uid string ⚡ Guest UID (alternative auth)
guest_password string ⚡ Guest Password (used with guest_uid)
key string ✅ Your API Key
✅ Success / ❌ Error Responses 
// Success
{
  "success": true,
  "BearerAuth": "eyJhbGciOiJSUzI1NiIs..."
}


// Errors
{
  "success": false,
  "message": "unregistered or banned account.",
  "detail": "jwt not found"
}

{
  "success": false,
  "message": "missing access_token (or guest_uid + guest_password)"
}

2. 🎽 Add Item

 

Equips items on a Free Fire account (outfit, gun skin, vehicle skin, vault items, etc.).

GET /additem/additem — Equip Item

GET /additem/additem?items=211050001,214050001,208050001&jwt=YOUR_JWT&key=YOUR_KEY
Parameter Type Required Description
items string ✅ Comma-separated item IDs
jwt string ✅ Free Fire JWT Bearer Token
key string ✅ Your API Key
✅ Success / ❌ Error Responses 
// Success
{
  "status": "success",
  "message": "Items added successfully!",
  "items_count": 3,
  "items": [
    211050001,
    214050001,
    208050001
  ]
}


// Errors
{
  "status": "error",
  "message": "Missing 'items' parameter."
}

{
  "status": "error",
  "message": "Missing 'jwt' parameter."
}

{
  "status": "error",
  "message": "Invalid item IDs. Provide comma-separated numbers."
}

{
  "status": "error",
  "message": "Failed to add items",
  "status_code": 401,
  "response": "Unauthorized"
}

3. 🚫 Ban Check

 

Checks the ban status of a Free Fire player by UID.

GET /bancheck/bancheck — Check Ban Status

GET /bancheck/bancheck?uid=2579249340&key=YOUR_KEY
Parameter Type Required Description
uid string ✅ Free Fire Player UID
key string ✅ Your API Key
✅ Success / ❌ Error Responses 
// Not Banned
{
  "nickname": "SiamBhau",
  "region": "BD",
  "ban_status": "Not banned",
  "ban_period": null
}


// Temporary Ban
{
  "nickname": "HackerXYZ",
  "region": "IND",
  "ban_status": "Banned for 3 months",
  "ban_period": "3 months"
}


// Permanent Ban
{
  "nickname": "Cheater99",
  "region": "SG",
  "ban_status": "Banned indefinitely",
  "ban_period": null
}


// Errors
{
  "error": "ID NOT FOUND"
}

{
  "error": "UID parameter is required"
}

{
  "error": "Failed to retrieve ban status"
}

4. 🔗 Bind Tools

 

Complete email bind toolkit — view bind info, change bound email (5-step OTP flow), unbind email (3-step), or cancel a pending bind request.

GET /bind/bind_info — View Email Bind Info

GET /bind/bind_info?access_token=YOUR_ACCESS_TOKEN&key=YOUR_KEY
Parameter Type Required Description
access_token string ✅ Garena OAuth Access Token
key string ✅ Your API Key
✅ Success Responses 
// Email Confirmed
{
  "status": "success",
  "status_code": 200,
  "data": {
    "current_email": "siamxus69@gmail.com",
    "pending_email": "",
    "countdown_seconds": 0,
    "countdown_human": "0",
    "raw_response": {
      "email": "siamxus69@gmail.com",
      "email_to_be": "",
      "request_exec_countdown": 0
    }
  },
  "summary": "Email confirmed: siamxus69@gmail.com"
}


// Pending Confirmation
{
  "status": "success",
  "status_code": 200,
  "data": {
    "current_email": "",
    "pending_email": "newmail@gmail.com",
    "countdown_seconds": 86400,
    "countdown_human": "1 Day 0 Hour 0 Min 0 Sec"
  },
  "summary": "Pending email confirmation: newmail@gmail.com - Confirms in: 1 Day 0 Hour 0 Min 0 Sec"
}


// No Email Set
{
  "status": "success",
  "data": {
    "current_email": "",
    "pending_email": ""
  },
  "summary": "No recovery email set"
}

POST /bind/changebind — Change Bound Email (5-Step OTP Flow)

Changes a Garena account's bound email — fully automated, requires OTP from old & new email.

POST /bind/changebind
Content-Type: application/json
?key=YOUR_KEY
Step Required Body Returns
1 access_token, old_email, step:1 OTP sent to old email
2 access_token, old_email, otp_old, step:2 identity_token
3 access_token, new_email, step:3 OTP sent to new email
4 access_token, new_email, otp_new, step:4 verifier_token
5 access_token, new_email, identity_token, verifier_token, step:5 ✅ Email change submitted
📦 Step-by-Step Examples 
// Step 1 — Send OTP to old email
{
  "access_token": "YOUR_TOKEN",
  "old_email": "old@gmail.com",
  "step": 1
}


// Step 2 — Verify old OTP
{
  "access_token": "YOUR_TOKEN",
  "old_email": "old@gmail.com",
  "otp_old": "123456",
  "step": 2
}


// Step 3 — Send OTP to new email
{
  "access_token": "YOUR_TOKEN",
  "new_email": "new@gmail.com",
  "step": 3
}


// Step 4 — Verify new OTP
{
  "access_token": "YOUR_TOKEN",
  "new_email": "new@gmail.com",
  "otp_new": "654321",
  "step": 4
}


// Step 5 — Confirm change
{
  "access_token": "YOUR_TOKEN",
  "new_email": "new@gmail.com",
  "identity_token": "FROM_STEP_2",
  "verifier_token": "FROM_STEP_4",
  "step": 5
}
✅ Success / ❌ Error Responses 
// Step success (typical)
{
  "success": true,
  "step": 1,
  "message": "OTP sent to old@gmail.com",
  "next": "Call step 2 with otp_old",
  "raw": {...}
}


// Step 5 final success
{
  "success": true,
  "step": 5,
  "message": "Email change request submitted successfully!"
}


// Errors
{
  "success": false,
  "error": "access_token is required"
}

{
  "success": false,
  "error": "step is required (1-5)"
}

{
  "success": false,
  "error": "old_email and otp_old required for step 2"
}

POST /bind/unbind — Unbind Email (3-Step Flow)

POST /bind/unbind
Content-Type: application/json
?key=YOUR_KEY
Step Required Body Returns
1 access_token, email, step:1 OTP sent to email
2 access_token, email, otp, step:2 identity_token
3 access_token, identity_token, step:3 ✅ Unbind submitted
📦 Step-by-Step Examples 
// Step 1
{
  "access_token": "YOUR_TOKEN",
  "email": "bound@gmail.com",
  "step": 1
}


// Step 2
{
  "access_token": "YOUR_TOKEN",
  "email": "bound@gmail.com",
  "otp": "123456",
  "step": 2
}


// Step 3
{
  "access_token": "YOUR_TOKEN",
  "identity_token": "FROM_STEP_2",
  "step": 3
}
✅ Success / ❌ Error Responses 
// Final success
{
  "success": true,
  "step": 3,
  "message": "Unbind request created successfully!"
}


// Errors
{
  "success": false,
  "error": "step must be 1 to 3"
}

{
  "success": false,
  "error": "email and otp required for step 2"
}

POST /bind/cancelbind — Cancel Pending Bind Request

POST /bind/cancelbind
Content-Type: application/json
?key=YOUR_KEY

{ "access_token": "YOUR_TOKEN" }
Body Field Type Required Description
access_token string ✅ Garena Access Token
✅ Success / ❌ Error Responses 
// Success
{
  "success": true,
  "message": "Bind cancelled successfully!",
  "raw": {...}
}


// Errors
{
  "success": false,
  "error": "access_token is required"
}

{
  "success": false,
  "message": "Cancel failed"
}

5. 🖼️ Banner

 

Generates a Free Fire player profile banner as a PNG image — Avatar, Banner, Guild Name, Level.

GET /banner/profile — Generate Profile Banner

GET /banner/profile?uid=2579249340&region=BD&key=YOUR_KEY
Parameter Type Required Default Description
uid string ✅ — Free Fire Player UID
region string ❌ BD Server Region Code
key string ✅ — Your API Key
✅ Success / ❌ Error Responses 
HTTP 200 OK
Content-Type: image/png
Cache-Control: public, max-age=300

[PNG Binary Image — Player Banner with Avatar + Name + Guild + Level]

🖼️ Returns a direct PNG. Use in browser URL or <img src="...">.

// Errors
{
  "error": "UID required"
}

{
  "error": "Info API Error: 500"
}

{
  "error": "Failed to generate banner"
}

6. 🎫 EAT To JWT

 

Decodes a Free Fire EAT (External Access Token) to extract account info and Garena Access Token.

GET /eattojwt/eat — EAT Token Decode

GET /eattojwt/eat?eat_token=YOUR_EAT_TOKEN&key=YOUR_KEY
Parameter Type Required Description
eat_token string ✅ Free Fire EAT Token
key string ✅ Your API Key
✅ Success / ❌ Error Responses 
// Success
{
  "status": "success",
  "account_id": "2579249340",
  "account_nickname": "SiamBhau",
  "open_id": "abc123def456ghi789jkl012",
  "access_token": "eyJhbGciOiJIUzI1NiIs...",
  "region": "BD"
}


// Errors
{
  "error": "Invalid access token or session expired"
}

{
  "error": "eat_token parameter is required"
}

{
  "error": "Failed to extract data from Garena"
}

7. 👤 Free Fire Info

   

  This group is FREE — request a complimentary key on Telegram. Complete profile info and game stats for Free Fire accounts.

GET /freefireinfo/bhau — Full Player Profile

GET /freefireinfo/bhau?uid=2579249340&region=BD&key=YOUR_KEY
Parameter Type Required Description
uid string ✅ Free Fire Player UID
region string ✅ Server Region (BD, IND, SG…)
key string ✅ Your API Key
✅ Full Success Response 
{
  "basicInfo": {
    "accountId": "2579249340",
    "accountType": 1,
    "nickname": "SiamBhau⸙",
    "region": "BD",
    "level": 68,
    "exp": 2464867,
    "bannerId": 901000011,
    "headPic": 902028017,
    "rank": 318,
    "rankingPoints": 3097,
    "badgeCnt": 8,
    "badgeId": 1001000096,
    "seasonId": 51,
    "liked": 61695,
    "lastLoginAt": "1777636197",
    "csRank": 322,
    "csRankingPoints": 117,
    "weaponSkinShows": [
      907193902,
      912037001
    ],
    "pinId": 910000009,
    "maxRank": 318,
    "csMaxRank": 322,
    "accountPrefers": {},
    "createAt": "1606659627",
    "title": 904090025,
    "externalIconInfo": {
      "status": "ExternalIconStatus_NOT_IN_USE",
      "showType": "ExternalIconShowType_FRIEND"
    },
    "releaseVersion": "OB53",
    "showBrRank": true,
    "showCsRank": true,
    "socialHighLightsWithBasicInfo": {},
    "primeInfo": {
      "primeLevel": 1
    }
  },
  "profileInfo": {
    "avatarId": 102000022,
    "skinColor": 50,
    "clothes": [
      205000051,
      211000579,
      214000022,
      211001035,
      203001159,
      204000581
    ],
    "equipedSkills": [
      16,
      3406,
      8,
      1,
      16,
      1806,
      8,
      2,
      16,
      4306,
      8,
      3,
      16,
      706
    ],
    "isSelected": true,
    "isSelectedAwaken": true,
    "unlockType": "UnlockType_LINK",
    "unlockTime": 1650796023,
    "isMarkedStar": true
  },
  "clanBasicInfo": {
    "clanId": "3048889605",
    "clanName": "Jᴜɴɪᴏʀ.Exper",
    "captainId": "6201276150",
    "clanLevel": 1,
    "capacity": 45,
    "memberNum": 32
  },
  "captainBasicInfo": {
    "accountId": "6201276150",
    "accountType": 1,
    "nickname": "সিয়ামভাই10k",
    "region": "BD",
    "level": 34,
    "exp": 68014,
    "bannerId": 901041021,
    "headPic": 902041014,
    "rank": 301,
    "rankingPoints": 1000,
    "badgeId": 1001000096,
    "seasonId": 51,
    "liked": 14028,
    "lastLoginAt": "1772468427",
    "csRank": 301,
    "weaponSkinShows": [
      907102812
    ],
    "pinId": 910040001,
    "maxRank": 301,
    "csMaxRank": 301,
    "accountPrefers": {},
    "createAt": "1651754222",
    "title": 904090015,
    "externalIconInfo": {
      "status": "ExternalIconStatus_NOT_IN_USE",
      "showType": "ExternalIconShowType_FRIEND"
    },
    "releaseVersion": "OB52",
    "socialHighLightsWithBasicInfo": {},
    "primeInfo": {}
  },
  "petInfo": {
    "id": 1300000126,
    "level": 4,
    "exp": 541,
    "isSelected": true,
    "skinId": 1310000262,
    "selectedSkillId": 1315000001,
    "isMarkedStar": true
  },
  "socialInfo": {
    "accountId": "2579249340",
    "gender": "Gender_MALE",
    "language": "Language_EN",
    "signature": "[b][c][FFFFFF] New Player Gonab :(",
    "rankShow": "RankShow_BR"
  },
  "diamondCostRes": {
    "diamondCost": 390
  },
  "creditScoreInfo": {
    "creditScore": 100,
    "rewardState": "REWARD_STATE_UNCLAIMED",
    "periodicSummaryEndTime": "1777586454"
  },
  "Owner": {
    "Owner": "SiamBhau",
    "Telegram": "t.me/SiamBhau"
  }
}
❌ Error Responses 
{
  "error": "Invalid UID or Region. Please check and try again."
}


{
  "error": "Please provide UID."
}


{
  "error": "Please provide REGION."
}

GET /freefireinfo/stats — Player Game Stats

GET /freefireinfo/stats?uid=2579249340&region=BD&key=YOUR_KEY
GET /freefireinfo/stats?uid=2579249340&region=BD&gamemode=br&matchmode=RANKED&key=YOUR_KEY
GET /freefireinfo/stats?uid=2579249340&region=BD&gamemode=cs&matchmode=RANKED&key=YOUR_KEY
Parameter Type Required Values Default Description
uid string ✅ — — Free Fire Player UID
region string ✅ Region codes — Server Region
gamemode string ❌ br, cs br Battle Royale or Clash Squad
matchmode string ❌ CAREER, NORMAL, RANKED CAREER Match type
key string ✅ — — Your API Key
✅ BR / CS Stats Responses 
// BR Career
{
  "success": true,
  "uid": "2579249340",
  "region": "BD",
  "gamemode": "br",
  "matchmode": "CAREER",
  "stats": {
    "rankingPoints": 4200,
    "rank": 220,
    "kills": 15800,
    "headshots": 6200,
    "winRate": 28,
    "gamesPlayed": 5200,
    "wins": 1456,
    "top10": 2800,
    "kd": 4.21,
    "longestKill": 423
  }
}


// CS Ranked
{
  "success": true,
  "uid": "2579249340",
  "region": "BD",
  "gamemode": "cs",
  "matchmode": "RANKED",
  "stats": {
    "rankingPoints": 3100,
    "cs_rank": 605,
    "kills": 8700,
    "headshots": 3900,
    "winRate": 58,
    "gamesPlayed": 1800,
    "wins": 1044,
    "kd": 3.87,
    "mvp": 420
  }
}

8. 👥 Friends

 

Complete friend management toolkit — add/remove friends, list friends, star/unstar friends, set/remove friend aliases.

GET /friends/friend_action — Add / Remove Friend

GET /friends/friend_action?jwt=YOUR_JWT&uid=TARGET_UID&action=add&key=YOUR_KEY
GET /friends/friend_action?jwt=YOUR_JWT&uid=TARGET_UID&action=remove&key=YOUR_KEY
Parameter Type Required Values Description
jwt string ✅ — Free Fire JWT Bearer Token
uid string ✅ — Target player UID
action string ✅ add, remove Action type
key string ✅ — Your API Key
✅ Success / ❌ Error Responses 
{
  "message": "Friend Request Sent Successfully",
  "response_status": 200
}


{
  "message": "Friend Removed Successfully",
  "response_status": 200
}


{
  "message": "Action Failed: ALREADY_FRIEND",
  "response_status": 400
}


{
  "message": "Invalid action. Use 'add' or 'remove'."
}


{
  "message": "JWT token is required as '?jwt=YOUR_TOKEN'"
}

GET /friends/list — Full Friends List

GET /friends/list?jwt=YOUR_JWT&key=YOUR_KEY
Parameter Type Required Description
jwt string ✅ Free Fire JWT Bearer Token
key string ✅ Your API Key (with friendslist access)
✅ Success / ❌ Error Responses 
{
  "success": true,
  "friends_count": 5,
  "friends_list": [
    {
      "nickname": "ProGamer01",
      "user_id": "1234567890"
    },
    {
      "nickname": "SnipeKing",
      "user_id": "9876543210"
    },
    {
      "nickname": "RushPlayer",
      "user_id": "4567891230"
    }
  ]
}


{
  "success": false,
  "error": "jwt parameter is required"
}


{
  "success": false,
  "error": "Connection timeout",
  "friends_count": 0,
  "friends_list": []
}

GET /friends/addstar — ⭐ Star a Friend

GET /friends/addstar?jwt=YOUR_JWT&uid=TARGET_UID&key=YOUR_KEY
Parameter Type Required Description
jwt string ✅ Your JWT Token (region auto-detected)
uid string ✅ Friend's UID to star
key string ✅ Your API Key
✅ Success / ❌ Error Responses 
// Success
{
  "status": "success",
  "message": "UID 1234567890 successfully starred ⭐",
  "response_hex": "0a..."
}


// Errors
{
  "error": "jwt parameter is required"
}

{
  "error": "uid parameter is required and must be a number"
}

{
  "error": "Invalid JWT: ...",
  "uid": 1234567890,
  "region": "BD"
}

{
  "error": "FF server returned 401"
}

GET /friends/removestar — Unstar a Friend

GET /friends/removestar?jwt=YOUR_JWT&uid=TARGET_UID&key=YOUR_KEY
Parameter Type Required Description
jwt string ✅ Your JWT Token
uid string ✅ Friend's UID to unstar
key string ✅ Your API Key
✅ Success Response 
{
  "status": "success",
  "message": "UID 1234567890 successfully unstarred ✅"
}

GET /friends/setalias — Set Friend Alias / Nickname

GET /friends/setalias?jwt=YOUR_JWT&uid=TARGET_UID&alias=BestBro&key=YOUR_KEY
Parameter Type Required Description
jwt string ✅ Your JWT Token
uid string ✅ Friend's UID
alias string ✅ New alias (max 12 characters)
key string ✅ Your API Key
✅ Success / ❌ Error Responses 
{
  "status": "success",
  "message": "Alias 'BestBro' set for UID 1234567890 ✅"
}


{
  "error": "alias parameter is required"
}


{
  "error": "Alias too long! Max 12 characters (got 18)"
}

GET /friends/removealias — Remove Friend Alias

GET /friends/removealias?jwt=YOUR_JWT&uid=TARGET_UID&key=YOUR_KEY
Parameter Type Required Description
jwt string ✅ Your JWT Token
uid string ✅ Friend's UID
key string ✅ Your API Key
✅ Success Response 
{
  "status": "success",
  "message": "Alias removed for UID 1234567890 ✅"
}

9. 🏰 Guild

 

Complete guild/clan management — read full guild info, join, leave, or create a brand new guild programmatically.

GET /guild/info — Guild / Clan Information

GET /guild/info?clan_id=3048889605&key=YOUR_KEY
Parameter Type Required Description
clan_id string ✅ Free Fire Guild/Clan ID
key string ✅ Your API Key (with guildinfo access)
✅ Full Success Response 
{
  "id": 3048889605,
  "clan_name": "BhauGuild",
  "level": 5,
  "region": "BD",
  "welcome_message": "Welcome to BhauGuild! Only pro players allowed.",
  "score": 98500,
  "rank": 12,
  "xp": 850000,
  "balance": 50000,
  "energy": 100,
  "upgrades": 15,
  "achievements": 8,
  "total_playtime": 9820000,
  "guild_details": {
    "region": "BD",
    "clan_id": 3048889605,
    "members_online": 8,
    "total_members": 30,
    "reward_time": 1750000000,
    "expire_time": 1752000000
  }
}
❌ Error Responses 
{
  "error": "clan_id parameter is required"
}


{
  "error": "Invalid clan_id"
}


{
  "error": "JWT token generation failed"
}


{
  "error": "FF server error: 500"
}

GET /guild/join — Join a Guild

GET /guild/join?clan_id=3048889605&jwt=YOUR_JWT&key=YOUR_KEY
GET /guild/join?clan_id=3048889605&uid=YOUR_UID&pass=YOUR_PASSWORD&key=YOUR_KEY
Parameter Type Required Description
clan_id string ✅ Target Guild/Clan ID
jwt string ⚡ Your JWT (preferred)
uid + pass string ⚡ UID + Password (alternative login)
key string ✅ Your API Key (with guild access)
✅ Success / ❌ Error Responses 
{
  "success": true,
  "action": "Join Guild",
  "clan_id": "3048889605",
  "uid": "2579249340",
  "name": "SiamBhau",
  "region": "BD",
  "login_method": "jwt",
  "server_response": ""
}


{
  "success": false,
  "error": "clan_id required"
}


{
  "success": false,
  "error": "Provide jwt OR (uid + pass)"
}

GET /guild/leave — Leave a Guild

GET /guild/leave?clan_id=3048889605&jwt=YOUR_JWT&key=YOUR_KEY
Parameter Type Required Description
clan_id string ✅ Current Guild/Clan ID
jwt string ⚡ Your JWT (preferred)
uid + pass string ⚡ UID + Password (alternative)
key string ✅ Your API Key
✅ Success Response 
{
  "success": true,
  "action": "Leave Guild",
  "clan_id": "3048889605",
  "uid": "2579249340",
  "region": "BD",
  "login_method": "jwt"
}

POST /guild/create — Create a New Guild

POST /guild/create?key=YOUR_KEY
Authorization: Bearer YOUR_JWT
Content-Type: application/json

{
  "guild_name": "MyGuild",
  "slogan":     "Best Guild BD",
  "payment":    1,
  "auto_approval": 2,
  "avatar":     10,
  "tags":       [1, 4, 13],
  "min_level":  20
}
Body Field Type Required Allowed Values Description
guild_name string ✅ — Guild display name
slogan string ✅ — Short slogan / tagline
payment integer ✅ 1 (Coins) / 2 (Diamonds) Payment currency
auto_approval integer ✅ 1 (OFF) / 2 (ON) Auto-approve members
avatar integer ✅ 10 (Lion) / 11 (Wolf) Guild avatar icon
tags array ✅ 1–14 (must include 13 or 14) Activity & category tags
min_level integer ❌ — Minimum player level
min_br_rank integer ❌ — Minimum BR rank
min_cs_rank integer ❌ — Minimum CS rank
location integer ❌ default 59999 Region code
✅ Success / ❌ Error Responses 
// Success
{
  "status": "success",
  "message": "Guild 'MyGuild' created successfully!",
  "guild_id": 3055551234,
  "guild_name": "MyGuild",
  "region": "BD"
}


// Errors
{
  "error": "Authorization header required. Format: Bearer <jwt_token>"
}

{
  "error": "guild_name is required"
}

{
  "error": "payment must be 1 (Coins) or 2 (Diamonds)"
}

{
  "error": "tags must include 13 (Casual) or 14 (Competition)"
}

{
  "error": "Only one activity tag (1/2/3) allowed, got: [1, 2]"
}

10. 🔓 JWT Decode

 

Decodes a Free Fire JWT Bearer Token and exposes the full payload.

GET /jwttokendecode/decode — Decode JWT

GET /jwttokendecode/decode?token=YOUR_JWT_TOKEN&key=YOUR_KEY
Parameter Type Required Description
token string ✅ Free Fire JWT Bearer Token
key string ✅ Your API Key
✅ Success / ❌ Error Responses 
{
  "status": "success",
  "decoded": {
    "account_id": "2579249340",
    "nickname": "SiamBhau",
    "lock_region": "BD",
    "open_id": "abc123def456",
    "platform_type": 4,
    "iat": 1748000000,
    "exp": "2026-05-29 13:11:47 UTC",
    "iss": "freefire-game-server",
    "sub": "game-auth"
  }
}


{
  "status": "error",
  "message": "Missing token parameter"
}


{
  "status": "error",
  "message": "Invalid JWT token"
}


{
  "status": "error",
  "message": "Token has expired"
}

11. ✏️ Long Bio

 

Sets a bio that exceeds the in-game character limit on a Free Fire account. Supports 3 auth methods.

GET /longbio/bio_upload — Upload Long Bio

▸ Method 1: Via JWT (fastest)

GET /longbio/bio_upload?bio=FF+Pro+Player+SiamBhau&jwt=YOUR_JWT&key=YOUR_KEY

▸ Method 2: Via UID + Password

GET /longbio/bio_upload?bio=BIO_TEXT&uid=YOUR_UID&pass=YOUR_PASS&key=YOUR_KEY

▸ Method 3: Via Access Token

GET /longbio/bio_upload?bio=BIO_TEXT&access=YOUR_ACCESS_TOKEN&key=YOUR_KEY
Parameter Type Required Description
bio string ✅ Bio text to set
jwt string ⚡ JWT — provide one of three auth methods
uid + pass string ⚡ UID + Password combo
access string ⚡ Garena Access Token
key string ✅ Your API Key
✅ Success / ❌ Error Responses 
// JWT method
{
  "Owner": "SiamBhau",
  "status": "Success",
  "login_method": "Direct JWT",
  "code": 200,
  "bio": "FF Pro Player SiamBhau",
  "uid": "2579249340",
  "name": "SiamBhau",
  "region": "BD",
  "generated_jwt": "eyJ..."
}


// UID/Pass method
{
  "Owner": "SiamBhau",
  "status": "Success",
  "login_method": "UID/Pass Login",
  "code": 200,
  "bio": "FF Pro Player SiamBhau",
  "uid": "2579249340",
  "name": "SiamBhau",
  "region": "BD"
}


// Errors
{
  "status": "Error",
  "code": 400,
  "error": "Missing 'bio' parameter"
}

{
  "status": "Error",
  "code": 400,
  "error": "Provide JWT, or UID/Pass, or Access Token"
}

{
  "status": "Unauthorized (Invalid JWT)",
  "code": 401
}

{
  "status": "Guest Login Failed (Check UID/Pass)",
  "code": 401
}

12. 🏷️ Name Changer

 

Changes the in-game name of a Free Fire account.

GET /namechanger/name — Change In-Game Name

GET /namechanger/name?token=YOUR_JWT&name=SiamBhau&key=YOUR_KEY
Parameter Type Required Description
token string ✅ Free Fire JWT Bearer Token
name string ✅ New in-game name
key string ✅ Your API Key
✅ Success / ❌ Error Responses 
// Success
{
  "Owner": "SiamBhau",
  "status": "success",
  "raw_content": "0a020801",
  "text": ""
}


// Name Already Used
{
  "Owner": "SiamBhau",
  "status": "failed",
  "raw_content": "...",
  "text": "BR_NAME_ALREADY_USED"
}


// Errors
{
  "error": "token and name are required"
}

13. 👗 Outfits

 

Renders a player's equipped outfit + character + weapon as a clean 1024 × 1024 PNG image.

GET /outfits/outfit — Generate Outfit Image

GET /outfits/outfit?uid=2579249340&region=BD&key=YOUR_KEY
Parameter Type Required Default Description
uid string ✅ — Free Fire Player UID
region string ❌ BD Server Region
key string ✅ — Your API Key
✅ Success / ❌ Error Responses 
HTTP 200 OK
Content-Type: image/png

[PNG Binary Image — 1024×1024px]
Outfit slots: Head, Body, Legs, Shoes, Backpack, Mask, Arm + Character + Weapon skin

🖼️ Returns a direct PNG. Use as <img src="API_URL">.

{
  "error": "uid parameter is required"
}


{
  "error": "Failed to fetch player info"
}


{
  "error": "Failed to fetch background image"
}

14. 🗺️ Craftlands

 

Fetches Free Fire Craftland custom map information by map code — basic info + full game details with tags, modes, and download links.

GET /craftlands/info — Craftland Map Info (Quick)

GET /craftlands/info?map_code=ABC123&region=BD&lang=en&key=YOUR_KEY
Parameter Type Required Default Description
map_code string ✅ — Craftland map code (with or without #)
region string ❌ BD Region code
lang string ❌ en Language code
key string ✅ — Your API Key
✅ Success Response 
{
  "code": 0,
  "status": "success",
  "msg": "",
  "data": {
    "map_info": {
      "workshop_code": "#ABC123",
      "author_name": "MapMaker01",
      "map_name": "Sniper Arena",
      "description": "Best 1v1 sniper map for Free Fire",
      "team_count": 2,
      "game_mode": 12,
      "subscribe_count": 15890,
      "like_count": 8420,
      "estimated_play_time": "300 seconds",
      "tags": [
        1,
        4,
        13
      ]
    },
    "game_info": {
      "title": "Free Fire Craftland",
      "game_name": "Free Fire",
      "region": "BD",
      "language": "en",
      "android_download": "https://play.google.com/store/apps/details?id=com.dts.freefireth",
      "ios_download": "https://apps.apple.com/app/garena-free-fire/id1300146617",
      "ugc_url": "https://ff.garena.com/craftland"
    },
    "images": {
      "backgrounds": [...],
      "game_icon": "...",
      "share_image": "..."
    },
    "timestamps": {
      "start_time": 1750000000,
      "end_time": 1755000000,
      "start_time_formatted": "2025-06-15 12:30:00",
      "end_time_formatted": "2025-08-12 12:30:00"
    }
  }
}
❌ Error Responses 
{
  "code": 400,
  "status": "error",
  "msg": "map_code is required",
  "data": null
}


{
  "code": 503,
  "status": "error",
  "msg": "Network error: ...",
  "data": null
}


{
  "code": 500,
  "status": "error",
  "msg": "Server error: ...",
  "data": null
}

GET /craftlands/map_details — Full Craftland Map Details

Returns enriched map info — tags resolved to human-readable names, game-mode + template names, full social/download/region data.

GET /craftlands/map_details?map_code=ABC123&region=BD&lang=en&key=YOUR_KEY
Parameter Type Required Default Description
map_code string ✅ — Craftland map code
region string ❌ BD Region code
lang string ❌ en Language code
key string ✅ — Your API Key
✅ Success Response 
{
  "code": 0,
  "status": "success",
  "data": {
    "basic_info": {
      "workshop_code": "#ABC123",
      "map_name": "Sniper Arena",
      "author": "MapMaker01",
      "description": "Best 1v1 sniper map for Free Fire",
      "short_description": "Sniper 1v1"
    },
    "gameplay_info": {
      "team_count": 2,
      "group_mode": 1,
      "game_mode": {
        "id": 12,
        "name": "Sniper Only"
      },
      "mode_template": {
        "id": 5,
        "name": "Free For All"
      },
      "round_count": 3,
      "map_id": 901,
      "estimated_play_time": "300 - 600 seconds"
    },
    "social_info": {
      "subscribe_count": 15890,
      "like_count": 8420,
      "map_cover_url": "https://..."
    },
    "tags": [
      {
        "id": 1,
        "key": "tag_action",
        "name": "Action",
        "type": 1
      },
      {
        "id": 4,
        "key": "tag_pvp",
        "name": "PvP",
        "type": 2
      },
      {
        "id": 13,
        "key": "tag_casual",
        "name": "Casual",
        "type": 3
      }
    ],
    "download_info": {
      "android": "https://play.google.com/store/apps/details?id=com.dts.freefireth",
      "ios": "https://apps.apple.com/app/garena-free-fire/id1300146617",
      "ugc_portal": "https://ff.garena.com/craftland"
    },
    "region_info": {
      "region": "BD",
      "language": "en",
      "region_lang": "en_BD"
    }
  }
}
❌ Error Responses 
{
  "error": "map_code is required"
}


{
  "error": "API returned status 404"
}

15. 👫 Dynamic Duo

 

Fetches a player's Dynamic Duo (special partner) information from Free Fire.

GET /dynamicduo/dynamicduo — Get Dynamic Duo Info

GET /dynamicduo/dynamicduo?uid=2579249340&region=BD&key=YOUR_KEY
Parameter Type Required Description
uid string ✅ Free Fire Player UID
region string ✅ Server Region Code (BD, IND, SG…)
key string ✅ Your API Key
✅ Success / ❌ Error Responses 
// ✅ Success
{
  "status": "success",
  "uid": "2579249340",
  "region": "BD",
  "dynamicduo": { "...": "..." },
  "Owner": { "Owner": "SiamBhau", "Telegram": "t.me/SiamBhau" }
}


// ❌ Errors
{ "error": "Please provide UID." }

{ "error": "Please provide REGION." }

{
  "status": "error",
  "message": "Failed to fetch Dynamic Duo info. Check UID/Region and try again."
}

16. 📜 Login History

 

Returns a player's full login history — device model, architecture, login type, and timestamps — via JWT token.

GET /loginhistory/history — Get Login History

GET /loginhistory/history?jwt=YOUR_JWT&key=YOUR_KEY
Parameter Type Required Description
jwt string ✅ Free Fire JWT Bearer Token
key string ✅ Your API Key
✅ Success / ❌ Error Responses 
// ✅ Success
{
  "status": "success",
  "loginhistory": {
    "nickname": "SiamBhau",
    "account_id": "2579249340",
    "region": "BD",
    "login_entries": [
      {
        "last_login_timestamp": 1777636197,
        "last_login_time": "2025-04-29 08:29:57",
        "extra": "",
        "device_model": "SM-A305F",
        "device_architecture": "arm64-v8a",
        "login_type": "Usual"
      }
    ]
  },
  "Owner": { "Owner": "SiamBhau", "Telegram": "t.me/SiamBhau" }
}


// ❌ Errors
{ "error": "Please provide 'jwt' parameter (your JWT token)." }

{ "status": "error", "message": "Invalid JWT token" }

{ "status": "error", "message": "Failed to fetch login history. Check your JWT token and try again." }

17. 🎁 Wish List

 

Retrieves a player's in-game Wish List — item IDs and their release timestamps.

GET /wish/wishlist — Get Player Wish List

GET /wish/wishlist?uid=2579249340&region=BD&key=YOUR_KEY
Parameter Type Required Description
uid string ✅ Free Fire Player UID
region string ✅ Server Region Code (BD, IND, SG…)
key string ✅ Your API Key
✅ Success / ❌ Error Responses 
// ✅ Success
{
  "status": "success",
  "uid": "2579249340",
  "region": "BD",
  "wishlist": [
    { "item_id": 911030141, "release_time": "2024-11-01 12:00:00" },
    { "item_id": 214050892, "release_time": "2024-09-15 08:00:00" }
  ],
  "Owner": { "Owner": "SiamBhau", "Telegram": "t.me/SiamBhau" }
}


// ❌ Errors
{ "error": "Please provide UID." }

{ "error": "Please provide REGION." }

{ "status": "error", "message": "Failed to fetch wishlist. Check UID/Region and try again." }

18. 💰 Wallet Info

 

Returns a player's in-game wallet — Coins, Gems, GOP Gems, total top-up history, and paid level.

GET /walletinfo/wallet — Get Wallet Info

GET /walletinfo/wallet?uid=2579249340&region=BD&key=YOUR_KEY
Parameter Type Required Description
uid string ✅ Free Fire Player UID
region string ✅ Server Region Code (BD, IND, SG…)
key string ✅ Your API Key
✅ Success / ❌ Error Responses 
// ✅ Success
{
  "status": "success",
  "uid": "2579249340",
  "region": "BD",
  "wallet": {
    "account_id": "2579249340",
    "paid_level": 3,
    "coins": 15420,
    "gems": 380,
    "gop_gems": 0,
    "total_topup": 3900,
    "last_topup_time": 1777636197,
    "last_topup_date": "2025-04-29 08:29:57"
  },
  "Owner": { "Owner": "SiamBhau", "Telegram": "t.me/SiamBhau" }
}


// ❌ Errors
{ "error": "Please provide UID." }

{ "error": "Please provide REGION." }

{ "status": "error", "message": "Failed to fetch wallet info. Check UID/Region and try again." }

19. 🔐 JWT Generate

 

Generates a Free Fire JWT Bearer Token via UID + Password or Garena Access Token. Faster and lighter than /accesstojwt.

GET /jwtgenerate/generate — Generate JWT

▸ Method 1: Via UID + Password

GET /jwtgenerate/generate?uid=4147917569&password=8415C426BBE3371DADD82F5B&key=YOUR_KEY

▸ Method 2: Via Access Token

GET /jwtgenerate/generate?access_token=YOUR_ACCESS_TOKEN&key=YOUR_KEY
Parameter Type Required Description
uid string ⚡ Free Fire Guest UID
password string ⚡ Account password (hex format)
access_token string ⚡ Garena Access Token (alternative)
key string ✅ Your API Key

⚡ = One auth method required: either uid + password or access_token.

✅ Success / ❌ Error Responses 
// ✅ Success — UID/Password
{
  "uid": "4147917569",
  "status": "live",
  "token": "eyJhbGciOiJSUzI1NiIs...",
  "region": "BD",
  "Owner": { "Owner": "SiamBhau", "Telegram": "t.me/SiamBhau" }
}


// ✅ Success — Access Token
{
  "uid": "2579249340",
  "status": "valid",
  "token": "eyJhbGciOiJSUzI1NiIs...",
  "region": "BD",
  "Owner": { "Owner": "SiamBhau", "Telegram": "t.me/SiamBhau" }
}


// ❌ Errors
{
  "uid": "4147917569",
  "status": "invalid",
  "message": "Wrong UID or Password. Please check and try again.",
  "credit": "@SiamBhau"
}

{ "error": "Please provide uid and password (or access_token)." }

🌍 Supported Regions

Code Region Location
BD 🇧🇩 Bangladesh South Asia
IND 🇮🇳 India South Asia
PK 🇵🇰 Pakistan South Asia
SG 🇸🇬 Singapore Southeast Asia
ID 🇮🇩 Indonesia Southeast Asia
TH 🇹🇭 Thailand Southeast Asia
VN 🇻🇳 Vietnam Southeast Asia
TW 🇹🇼 Taiwan East Asia
BR 🇧🇷 Brazil South America
SAC 🌎 South America South America
US 🇺🇸 United States North America
NA 🌎 North America North America
ME 🌍 Middle East Middle East
RU 🇷🇺 Russia CIS
CIS 🌍 CIS Countries CIS
EUROPE 🇪🇺 Europe Europe

⚠️ Error Reference

HTTP Status Badge Description
200 Request completed successfully
400 Missing or invalid parameter
401 Invalid JWT or login failed
403 Invalid / expired / no-access API key
404 Player or data not found
500 Internal error or upstream failure
502 Free Fire server error
504 Request timeout

📞 Contact


   


💬 For API keys, pricing, custom endpoints, or any questions — message on Telegram!


🎁 Get a Free API Key instantly! Complete quick tasks (GitHub follow + Telegram join) at siambhau69.eu.cc/GetFreeApiKey — no need to message anyone!


© SiamBhau · Free Fire Centralized API · Premium Access Only · Unauthorized resale is prohibited.


About

Free Fire Centralized REST API — 34 endpoints across 19 groups. Player Info, JWT, Ban Check, Guild Tools, Bind/Unbind, Outfits, Craftlands & more. Player Info group is FREE!

siambhau.eu.cc

Topics

ff-uid-checkffapiffinfoffuidcheckerfree-fire-apifree-fire-info-apifreefirefreefire-apifreefireinfofreefireinfoapifreefiretoolsfreeinfoapigarena-apigarena-ff-apigarena-freefire-apiuid-checkeruidchecker

Resources

Readme
Activity

Stars

366 stars

Watchers

5 watching

Forks

42 forks
Report repository

Releases

Packages

Contributors

Languages