Instantly fetch any Free Fire player's full profile — stats, cosmetics, clan, pet, credit score and CDN images — pulled live from Garena servers on every request.
Send a GET request with three query parameters. The base URL is auto-detected from the current site.
…
…
All three parameters are required and passed as URL query strings.
| Parameter | Type | Required | Description |
|---|---|---|---|
| uid | integer | required | Player's Free Fire numeric UID — 5 to 12 digits. Found on the in-game profile page. |
| region | string | required | Server region code (uppercase). Must match the player's registered server. See the region list below. |
| pass | string | required | Private access key for authentication. Contact the developer via Telegram to obtain yours. |
// Missing uid { "error": { "code": "MISSING_UID", "message": "Parameter 'uid' is required." } } // Wrong region { "error": { "code": "INVALID_REGION", "message": "Region 'XYZ' is not supported." } }
Use the exact region code shown. The API normalises case automatically.
Every success returns a JSON envelope with 8 data sections and no duplicated fields.
{
"status": "success",
"api_version": "4.0.0",
"realtime": true,
"cached": false,
"timestamp": "2025-05-03T12:00:00Z",
"data": {
"basicInfo", // Identity, rank, badges, highlights
"profileInfo", // Avatar, outfit, equipped skills
"socialInfo", // Gender, language, bio, mode preference
"clanBasicInfo", // Clan name, level, captain, members
"petInfo", // Pet name, level, EXP, active skill
"creditScoreInfo", // Credit score, reward state
"diamondCostRes", // Total diamonds spent
"cdnUrls" // CDN PNG image links for all items
}
}
All errors return a JSON body with "status":"error" and an error object.
{
"status": "error",
"api_version": "4.0.0",
"error": {
"code": "PLAYER_NOT_FOUND",
"message": "Player UID 999 not found in region BD."
}
}
| HTTP | Error Code | Cause |
|---|---|---|
| 401 | UNAUTHORIZED | Invalid or missing access key |
| 400 | MISSING_UID | uid parameter not provided |
| 400 | MISSING_REGION | region parameter not provided |
| 400 | INVALID_UID | UID is not a 5–12 digit number |
| 400 | INVALID_REGION | Region code not in the supported list |
| 404 | PLAYER_NOT_FOUND | No player found for that UID in the given region |
| 500 | INTERNAL_ERROR | Upstream Garena API error or network timeout |
Get your access key, ask questions, report issues, and stay updated with the latest API changes on our Telegram channel.
Open Telegram Channel