Get Player Statistics

GET /stats

Retrieves detailed career gameplay statistics for a player across different Battle Royale game modes (Solo, Duo, Squad).

This endpoint provides comprehensive career stats including:

Total games played, wins, and eliminations
Highest eliminations in a single match
Headshot statistics
Vehicle eliminations
Knockdowns and revives (for duo/squad modes)
Top placement counts (top 3, top 5, top 10)

Statistics represent the player's all-time career performance in each mode.

Headers

x-api-key string

Your API key from the developer portal (Header method - Recommended).

Alternative: You can also pass the API key as a query parameter ?key=your_api_key

Query parameters

region string Required
The region code for the player's account:
- sg: Singapore region (covers SG, ID, ME, VN, TH, CIS, EU, TW, MY, PK, BD)
- ind: India region (covers IND only)
- br: Brazil region (covers BR, US, NA, LATAM)
Values are sg, ind, or br.
uid string Required

The unique player User ID (10-12 digits)

Format should match the following pattern: ^\d{10,12}$.

Responses

200 application/json

Successfully retrieved player statistics
Hide headers attributes Show headers attributes
- X-RateLimit-Limit
  
  The maximum number of requests allowed in the current time window
- X-RateLimit-Remaining
  
  The number of requests remaining in the current time window
- X-RateLimit-Reset
  
  The time when the rate limit resets (Unix timestamp)
Hide response attributes Show response attributes object
- brCareer_solo object
- brCareer_duo object
- brCareer_squad object
400 application/json

Bad request - Invalid parameters
Hide response attributes Show response attributes object
- error string
- message string
- status integer
401 application/json

Unauthorized - Invalid or missing API key
Hide response attributes Show response attributes object
- error string
- message string
- status integer
403 application/json

Forbidden - API key doesn't have access
Hide response attributes Show response attributes object
- error string
- message string
- status integer
429 application/json

Too many requests - Rate limit exceeded
Hide response attributes Show response attributes object
- error string
- message string
- status integer
500 application/json

Internal server error
Hide response attributes Show response attributes object
- error string
- message string
- status integer

GET /stats

curl \
 --request GET 'https://developers.freefirecommunity.com/api/v1/stats?region=ind&uid=665951869' \
 --header "x-api-key: ffc_1234567890_abcdefghijk"

Response examples (200)

# Headers
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1735689600

# Payload
{
  "brCareer_solo": {},
  "brCareer_duo": {},
  "brCareer_squad": {}
}

Response examples (400)

{
  "error": "string",
  "message": "string",
  "status": 42
}

Response examples (401)

{
  "error": "string",
  "message": "string",
  "status": 42
}

Response examples (403)

{
  "error": "string",
  "message": "string",
  "status": 42
}

Response examples (429)

{
  "error": "string",
  "message": "string",
  "status": 42
}

Response examples (500)

{
  "error": "string",
  "message": "string",
  "status": 42
}