FreeFireApi

KO | EN

gitlite — search

#python #hacktoberfest #ai #typescript #android #rust #linux #docker #macos #awesome #awesome-list #security #mcp #ios

(★ 226)

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

File Explorer

Download Latest Version (.zip)

- - index-DeeKjjet.css
  - index-KcoAkV-w.js
- favicon.svg
- icons.svg
- index.html
- favicon.svg
- icons.svg
- - hero.png
- App.css
- App.tsx
- index.css
- main.tsx
eslint.config.js
index.html
package-lock.json
package.json
README.md
tsconfig.app.json
tsconfig.json
tsconfig.node.json
vercel.json
vite.config.ts

# Installation Guide

1. Get the code

git clone https://github.com/siambhau/FreeFireApi

Downloads the entire project code from GitHub to your computer.

cd FreeFireApi

Moves into the project folder you just downloaded.

2. Node.js

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Node.js Node.js must be installed to use npm. The LTS version is recommended.

npm install

Downloads and installs the libraries listed in package.json.

npm start

Starts the development/run server.

✅ After running the command, open the address shown in the terminal (usually something like http://localhost:3000) in your browser.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Typing SVG](https://readme-typing-svg.demolab.com?font=JetBrains+Mono&weight=700&size=22&pause=800&color=FF6B00&center=true&vCenter=true&multiline=true&width=820&height=80&lines=Free+Fire+Centralized+API+System+v6.0;19+Groups+%E2%80%A2+34+Endpoints+%E2%80%A2+Player+Info+is+FREE+%F0%9F%92%8E)](https://git.io/typing-svg)

<blockquote>
<img src="https://img.shields.io/badge/⚡-PREMIUM-FF6B00?style=flat-square&labelColor=0d1117" /> &nbsp;
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.
</blockquote>

</div>

---

## <img src="https://fonts.gstatic.com/s/e/notoemoji/latest/1f4d1/512.gif" width="22" align="center"/> &nbsp;Table of Contents

Click any card to jump to that section

<table>
 <tr>
 <td align="center" width="200">
 <a href="#1--access-to-jwt">
 <img src="https://fonts.gstatic.com/s/e/notoemoji/latest/1f511/512.gif" width="28" /> 
 Access To JWT 
 <code>/accesstojwt</code> 
 <img src="https://img.shields.io/badge/2-endpoints-FF6B00?style=flat-square&labelColor=0d1117"/>
 </a>
 </td>
 <td align="center" width="200">
 <a href="#2--add-item">
 <img src="https://fonts.gstatic.com/s/e/notoemoji/latest/1f455/512.gif" width="28" /> 
 Add Item 
 <code>/additem</code> 
 <img src="https://img.shields.io/badge/1-endpoint-8B5CF6?style=flat-square&labelColor=0d1117"/>
 </a>
 </td>
 <td align="center" width="200">
 <a href="#3--ban-check">
 <img src="https://fonts.gstatic.com/s/e/notoemoji/latest/26d4/512.gif" width="28" /> 
 Ban Check 
 <code>/bancheck</code> 
 <img src="https://img.shields.io/badge/1-endpoint-FF0000?style=flat-square&labelColor=0d1117"/>
 </a>
 </td>
 </tr>
 <tr>
 <td align="center">
 <a href="#4--bind-tools">
 <img src="https://fonts.gstatic.com/s/e/notoemoji/latest/1f517/512.gif" width="28" /> 
 Bind Tools 
 <code>/bind</code> 
 <img src="https://img.shields.io/badge/4-endpoints-2CA5E0?style=flat-square&labelColor=0d1117"/>
 </a>
 </td>
 <td align="center">
 <a href="#5-️-banner">
 <img src="https://fonts.gstatic.com/s/e/notoemoji/latest/1f5bc_fe0f/512.gif" width="28" /> 
 Banner 
 <code>/banner</code> 
 <img src="https://img.shields.io/badge/1-endpoint-FF6B00?style=flat-square&labelColor=0d1117"/>
 </a>
 </td>
 <td align="center">
 <a href="#6--eat-to-jwt">
 <img src="https://fonts.gstatic.com/s/e/notoemoji/latest/1f39f_fe0f/512.gif" width="28" /> 
 EAT To JWT 
 <code>/eattojwt</code> 
 <img src="https://img.shields.io/badge/1-endpoint-00C851?style=flat-square&labelColor=0d1117"/>
 </a>
 </td>
 </tr>
 <tr>
 <td align="center">
 <a href="#7--free-fire-info">
 <img src="https://fonts.gstatic.com/s/e/notoemoji/latest/1f464/512.gif" width="28" /> 
 Free Fire Info <img src="https://fonts.gstatic.com/s/e/notoemoji/latest/1f193/512.gif" width="16" align="center"/> 
 <code>/freefireinfo</code> 
 <img src="https://img.shields.io/badge/2-endpoints-00C851?style=flat-square&labelColor=0d1117"/>
 </a>
 </td>
 <td align="center">
 <a href="#8--friends">
 <img src="https://fonts.gstatic.com/s/e/notoemoji/latest/1fac2/512.gif" width="28" /> 
 Friends 
 <code>/friends</code> 
 <img src="https://img.shields.io/badge/6-endpoints-2CA5E0?style=flat-square&labelColor=0d1117"/>
 </a>
 </td>
 <td align="center">
 <a href="#9--guild">
 <img src="https://fonts.gstatic.com/s/e/notoemoji/latest/1f6e1_fe0f/512.gif" width="28" /> 
 Guild 
 <code>/guild</code> 
 <img src="https://img.shields.io/badge/4-endpoints-FF6B00?style=flat-square&labelColor=0d1117"/>
 </a>
 </td>
 </tr>
 <tr>
 <td align="center">
 <a href="#10--jwt-decode">
 <img src="https://fonts.gstatic.com/s/e/notoemoji/latest/1f513/512.gif" width="28" /> 
 JWT Decode 
 <code>/jwttokendecode</code> 
 <img src="https://img.shields.io/badge/1-endpoint-8B5CF6?style=flat-square&labelColor=0d1117"/>
 </a>
 </td>
 <td align="center">
 <a href="#11-️-long-bio">
 <img src="https://fonts.gstatic.com/s/e/notoemoji/latest/1f4dd/512.gif" width="28" /> 
 Long Bio 
 <code>/longbio</code> 
 <img src="https://img.shields.io/badge/1-endpoint-FF6B00?style=flat-square&labelColor=0d1117"/>
 </a>
 </td>
 </tr>
 <tr>
 <td align="center">
 <a href="#12-️-name-changer">
 <img src="https://fonts.gstatic.com/s/e/notoemoji/latest/1f3f7_fe0f/512.gif" width="28" /> 
 Name Changer 
 <code>/namechanger</code> 
 <img src="https://img.shields.io/badge/1-endpoint-2CA5E0?style=flat-square&labelColor=0d1117"/>
 </a>
 </td>
 <td align="center">
 <a href="#13--outfits">
 <img src="https://fonts.gstatic.com/s/e/notoemoji/latest/1f9e5/512.gif" width="28" /> 
 Outfits 
 <code>/outfits</code> 
 <img src="https://img.shields.io/badge/1-endpoint-FF6B00?style=flat-square&labelColor=0d1117"/>
 </a>
 </td>
 <td align="center">
 <a href="#14-️-craftlands">
 <img src="https://fonts.gstatic.com/s/e/notoemoji/latest/1f5fa_fe0f/512.gif" width="28" /> 
 Craftlands 
 <code>/craftlands</code> 
 <img src="https://img.shields.io/badge/2-endpoints-00C851?style=flat-square&labelColor=0d1117"/>
 </a>
 </td>
 </tr>
 <tr>
 <td align="center">
 <a href="#15--dynamic-duo">
 <img src="https://fonts.gstatic.com/s/e/notoemoji/latest/1fac2/512.gif" width="28" /> 
 Dynamic Duo 
 <code>/dynamicduo</code> 
 <img src="https://img.shields.io/badge/1-endpoint-2CA5E0?style=flat-square&labelColor=0d1117"/>
 </a>
 </td>
 <td align="center">
 <a href="#16--login-history">
 <img src="https://fonts.gstatic.com/s/e/notoemoji/latest/1f4dc/512.gif" width="28" /> 
 Login History 
 <code>/loginhistory</code> 
 <img src="https://img.shields.io/badge/1-endpoint-FF0000?style=flat-square&labelColor=0d1117"/>
 </a>
 </td>
 <td align="center">
 <a href="#17--wish-list">
 <img src="https://fonts.gstatic.com/s/e/notoemoji/latest/1f381/512.gif" width="28" /> 
 Wish List 
 <code>/wish</code> 
 <img src="https://img.shields.io/badge/1-endpoint-FF6B00?style=flat-square&labelColor=0d1117"/>
 </a>
 </td>
 </tr>
 <tr>
 <td align="center">
 <a href="#18--wallet-info">
 <img src="https://fonts.gstatic.com/s/e/notoemoji/latest/1f4b0/512.gif" width="28" /> 
 Wallet Info 
 <code>/walletinfo</code> 
 <img src="https://img.shields.io/badge/1-endpoint-00C851?style=flat-square&labelColor=0d1117"/>
 </a>
 </td>
 <td align="center">
 <a href="#19--jwt-generate">
 <img src="https://fonts.gstatic.com/s/e/notoemoji/latest/1f510/512.gif" width="28" /> 
 JWT Generate 
 <code>/jwtgenerate</code> 
 <img src="https://img.shields.io/badge/1-endpoint-8B5CF6?style=flat-square&labelColor=0d1117"/>
 </a>
 </td>
 <td></td>
 </tr>
</table>

<table>
 <tr>
 <td align="center" width="160">
 <a href="#-base-url--authentication">
 <img src="https://fonts.gstatic.com/s/e/notoemoji/latest/1f310/512.gif" width="22" /> 
 Base URL & Auth
 </a>
 </td>
 <td align="center" width="160">
 <a href="#-all-api-groups">
 <img src="https://fonts.gstatic.com/s/e/notoemoji/latest/1f4cb/512.gif" width="22" /> 
 All Groups
 </a>
 </td>
 <td align="center" width="160">
 <a href="#-supported-regions">
 <img src="https://fonts.gstatic.com/s/e/notoemoji/latest/1f30d/512.gif" width="22" /> 
 Regions
 </a>
 </td>
 <td align="center" width="160">
 <a href="#️-error-reference">
 <img src="https://fonts.gstatic.com/s/e/notoemoji/latest/26a0_fe0f/512.gif" width="22" /> 
 Errors
 </a>
 </td>
 <td align="center" width="160">
 <a href="#-contact">
 <img src="https://fonts.gstatic.com/s/e/notoemoji/latest/1f4de/512.gif" width="22" /> 
 Contact
 </a>
 </td>
 </tr>
</table>

</div>

---

## 🌐 Base URL & Authentication

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

> <img src="https://img.shields.io/badge/🔑-API%20Key%20Required-FF6B00?style=flat-square&labelColor=0d1117" /> &nbsp; **Every request requires a valid API Key.** Keys are sold individually with per-endpoint access. Contact **[@SiamBhau](https://t.me/SiamBhau)** to purchase.

Add the `key` query parameter to every request:

```
http://siambhau69.eu.cc/<group>/<endpoint>?param=VALUE&key=YOUR_KEY
```

<details>
<summary>🔐 Authentication Error Responses (HTTP 403)</summary>

```json
// 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"
}
```

</details>

---

## 📋 All API Groups

```http
GET http://siambhau69.eu.cc/
```

<details>
<summary>📄 View Full Response (19 Groups)</summary>

```json
{
  "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"
  }
}
```

</details>

---

## 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

```http
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

```http
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 |

<details>
<summary>✅ Success / ❌ Error Responses</summary>

```json
// 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"
}
```

</details>

---

### `GET /accesstojwt/get_jwt` — Return JWT Only

```http
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 |

<details>
<summary>✅ Success / ❌ Error Responses</summary>

```json
// 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)"
}
```

</details>

---

## 2. 🎽 Add Item

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

### `GET /additem/additem` — Equip Item

```http
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 |

<details>
<summary>✅ Success / ❌ Error Responses</summary>

```json
// 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"
}
```

</details>

---

## 3. 🚫 Ban Check

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

### `GET /bancheck/bancheck` — Check Ban Status

```http
GET /bancheck/bancheck?uid=2579249340&key=YOUR_KEY
```

| Parameter | Type | Required | Description |
|-----------|------|:--------:|-------------|
| `uid` | string | ✅ | Free Fire Player UID |
| `key` | string | ✅ | Your API Key |

<details>
<summary>✅ Success / ❌ Error Responses</summary>

```json
// 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"
}
```

</details>

---

## 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

```http
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 |

<details>
<summary>✅ Success Responses</summary>

```json
// 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"
}
```

</details>

---

### `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.

```http
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 |

<details>
<summary>📦 Step-by-Step Examples</summary>

```json
// 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
}
```

</details>

<details>
<summary>✅ Success / ❌ Error Responses</summary>

```json
// 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"
}
```

</details>

---

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

```http
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 |

<details>
<summary>📦 Step-by-Step Examples</summary>

```json
// 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
}
```

</details>

<details>
<summary>✅ Success / ❌ Error Responses</summary>

```json
// 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"
}
```

</details>

---

### `POST /bind/cancelbind` — Cancel Pending Bind Request

```http
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 |

<details>
<summary>✅ Success / ❌ Error Responses</summary>

```json
// Success
{
  "success": true,
  "message": "Bind cancelled successfully!",
  "raw": {...}
}

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

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

</details>

---

## 5. 🖼️ Banner

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

### `GET /banner/profile` — Generate Profile Banner

```http
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 |

<details>
<summary>✅ Success / ❌ Error Responses</summary>

```
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="...">`.

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

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

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

</details>

---

## 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

```http
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 |

<details>
<summary>✅ Success / ❌ Error Responses</summary>

```json
// 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"
}
```

</details>

---

## 7. 👤 Free Fire Info

> <img src="https://fonts.gstatic.com/s/e/notoemoji/latest/1f193/512.gif" width="16" align="center"/> &nbsp; **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

```http
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 |

<details>
<summary>✅ Full Success Response</summary>

```json
{
  "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"
  }
}
```

</details>

<details>
<summary>❌ Error Responses</summary>

```json
{
  "error": "Invalid UID or Region. Please check and try again."
}

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

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

</details>

---

### `GET /freefireinfo/stats` — Player Game Stats

```http
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 |

<details>
<summary>✅ BR / CS Stats Responses</summary>

```json
// 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
  }
}
```

</details>

---

## 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

```http
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 |

<details>
<summary>✅ Success / ❌ Error Responses</summary>

```json
{
  "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'"
}
```

</details>

---

### `GET /friends/list` — Full Friends List

```http
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) |

<details>
<summary>✅ Success / ❌ Error Responses</summary>

```json
{
  "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": []
}
```

</details>

---

### `GET /friends/addstar` — ⭐ Star a Friend

```http
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 |

<details>
<summary>✅ Success / ❌ Error Responses</summary>

```json
// 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"
}
```

</details>

---

### `GET /friends/removestar` — Unstar a Friend

```http
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 |

<details>
<summary>✅ Success Response</summary>

```json
{
  "status": "success",
  "message": "UID 1234567890 successfully unstarred ✅"
}
```

</details>

---

### `GET /friends/setalias` — Set Friend Alias / Nickname

```http
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 |

<details>
<summary>✅ Success / ❌ Error Responses</summary>

```json
{
  "status": "success",
  "message": "Alias 'BestBro' set for UID 1234567890 ✅"
}

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

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

</details>

---

### `GET /friends/removealias` — Remove Friend Alias

```http
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 |

<details>
<summary>✅ Success Response</summary>

```json
{
  "status": "success",
  "message": "Alias removed for UID 1234567890 ✅"
}
```

</details>

---

## 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

```http
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) |

<details>
<summary>✅ Full Success Response</summary>

```json
{
  "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
  }
}
```

</details>

<details>
<summary>❌ Error Responses</summary>

```json
{
  "error": "clan_id parameter is required"
}

{
  "error": "Invalid clan_id"
}

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

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

</details>

---

### `GET /guild/join` — Join a Guild

```http
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) |

<details>
<summary>✅ Success / ❌ Error Responses</summary>

```json
{
  "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)"
}
```

</details>

---

### `GET /guild/leave` — Leave a Guild

```http
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 |

<details>
<summary>✅ Success Response</summary>

```json
{
  "success": true,
  "action": "Leave Guild",
  "clan_id": "3048889605",
  "uid": "2579249340",
  "region": "BD",
  "login_method": "jwt"
}
```

</details>

---

### `POST /guild/create` — Create a New Guild

```http
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 |

<details>
<summary>✅ Success / ❌ Error Responses</summary>

```json
// 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]"
}
```

</details>

---

## 10. 🔓 JWT Decode

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

### `GET /jwttokendecode/decode` — Decode JWT

```http
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 |

<details>
<summary>✅ Success / ❌ Error Responses</summary>

```json
{
  "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"
}
```

</details>

---

## 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)*
```http
GET /longbio/bio_upload?bio=FF+Pro+Player+SiamBhau&jwt=YOUR_JWT&key=YOUR_KEY
```

#### ▸ Method 2: Via UID + Password
```http
GET /longbio/bio_upload?bio=BIO_TEXT&uid=YOUR_UID&pass=YOUR_PASS&key=YOUR_KEY
```

#### ▸ Method 3: Via Access Token
```http
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 |

<details>
<summary>✅ Success / ❌ Error Responses</summary>

```json
// 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
}
```

</details>

---

## 12. 🏷️ Name Changer

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

### `GET /namechanger/name` — Change In-Game Name

```http
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 |

<details>
<summary>✅ Success / ❌ Error Responses</summary>

```json
// 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"
}
```

</details>

---

## 13. 👗 Outfits

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

### `GET /outfits/outfit` — Generate Outfit Image

```http
GET /outfits/outfit?uid=2579249340&region=BD&key=YOUR_KEY
```

<details>
<summary>✅ Success / ❌ Error Responses</summary>

```
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">`.

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

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

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

</details>

---

## 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)

```http
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 |

<details>
<summary>✅ Success Response</summary>

```json
{
  "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"
    }
  }
}
```

</details>

<details>
<summary>❌ Error Responses</summary>

```json
{
  "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
}
```

</details>

---

### `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.

```http
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 |

<details>
<summary>✅ Success Response</summary>

```json
{
  "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"
    }
  }
}
```

</details>

<details>
<summary>❌ Error Responses</summary>

```json
{
  "error": "map_code is required"
}

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

</details>

---

## 15. 👫 Dynamic Duo

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

### `GET /dynamicduo/dynamicduo` — Get Dynamic Duo Info

```http
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 |

<details>
<summary>✅ Success / ❌ Error Responses</summary>

```json
// ✅ 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."
}
```

</details>

---

## 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

```http
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 |

<details>
<summary>✅ Success / ❌ Error Responses</summary>

```json
// ✅ 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." }
```

</details>

---

## 17. 🎁 Wish List

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

### `GET /wish/wishlist` — Get Player Wish List

```http
GET /wish/wishlist?uid=2579249340&region=BD&key=YOUR_KEY
```

<details>
<summary>✅ Success / ❌ Error Responses</summary>

```json
// ✅ 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." }
```

</details>

---

## 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

```http
GET /walletinfo/wallet?uid=2579249340&region=BD&key=YOUR_KEY
```

<details>
<summary>✅ Success / ❌ Error Responses</summary>

```json
// ✅ 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." }
```

</details>

---

## 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

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

#### ▸ Method 2: Via Access Token

```http
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`.

<details>
<summary>✅ Success / ❌ Error Responses</summary>

```json
// ✅ 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)." }
```

</details>

---

## 🌍 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 |

</div>

---

## ⚠️ Error Reference

| HTTP Status | Badge | Description |
|:-----------:|-------|-------------|
| `200` | ![](https://img.shields.io/badge/200-Success-00C851?style=flat-square) | Request completed successfully |
| `400` | ![](https://img.shields.io/badge/400-Bad%20Request-FF6B00?style=flat-square) | Missing or invalid parameter |
| `401` | ![](https://img.shields.io/badge/401-Unauthorized-FF0000?style=flat-square) | Invalid JWT or login failed |
| `403` | ![](https://img.shields.io/badge/403-Forbidden-FF0000?style=flat-square) | Invalid / expired / no-access API key |
| `404` | ![](https://img.shields.io/badge/404-Not%20Found-8B5CF6?style=flat-square) | Player or data not found |
| `500` | ![](https://img.shields.io/badge/500-Server%20Error-FF0000?style=flat-square) | Internal error or upstream failure |
| `502` | ![](https://img.shields.io/badge/502-Bad%20Gateway-FF0000?style=flat-square) | Free Fire server error |
| `504` | ![](https://img.shields.io/badge/504-Timeout-FF6B00?style=flat-square) | Request timeout |

</div>

---

## 📞 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](https://siambhau69.eu.cc/GetFreeApiKey)** — no need to message anyone!

</div>

FreeFireApi

File Explorer

# Installation Guide

2. Node.js

Today's picks

Was this content helpful?

Recent Feedback

FreeFireApi

File Explorer

# Installation Guide

2. Node.js

Today's picks

Was this content helpful?

Recent Feedback

Download README