Get Player Statistics

GET /api/{region}

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

This endpoint provides comprehensive stats including:

Games played and wins
Total kills and highest kills in a match
Deaths and K/D ratio data
Damage dealt and headshot statistics
Distance travelled and survival time
Revival and knockdown counts
Item pickups and more

Statistics are broken down by game mode for detailed analysis.

Path 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.

Query parameters

uid string Required

The unique player User ID (10-12 digits)

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

Your API key from the developer portal

Responses

200 application/json

Successfully retrieved player statistics
Hide response attributes Show response attributes object
- success boolean
  
  Whether the request was successful
- soloStats object
  
  Statistics for a specific game mode
  
  Hide soloStats attributes Show soloStats attributes object
  
  accountId string
  
  Player's account ID
  
  gamesPlayed integer
  
  Total games played in this mode
  
  wins integer
  
  Total wins in this mode
  
  kills integer
  
  Total kills in this mode
  
  detailedStats object
  
  Detailed breakdown of statistics
  
  Hide detailedStats attributes Show detailedStats attributes object
  
  deaths integer
  
  Total deaths
  
  topNTimes integer
  
  Number of top placements
  
  distanceTravelled integer
  
  Total distance travelled in meters
  
  survivalTime integer
  
  Total survival time in seconds
  
  revives integer
  
  Total teammate revives
  
  highestKills integer
  
  Highest kills in a single match
  
  damage integer
  
  Total damage dealt
  
  headshots integer
  
  Total headshots landed
  
  headshotKills integer
  
  Total kills with headshots
  
  knockDown integer
  
  Total enemy knockdowns
  
  pickUps integer
  
  Total items picked up
- duoStats object
  
  Statistics for a specific game mode
  
  Hide duoStats attributes Show duoStats attributes object
  
  accountId string
  
  Player's account ID
  
  gamesPlayed integer
  
  Total games played in this mode
  
  wins integer
  
  Total wins in this mode
  
  kills integer
  
  Total kills in this mode
  
  detailedStats object
  
  Detailed breakdown of statistics
  
  Hide detailedStats attributes Show detailedStats attributes object
  
  deaths integer
  
  Total deaths
  
  topNTimes integer
  
  Number of top placements
  
  distanceTravelled integer
  
  Total distance travelled in meters
  
  survivalTime integer
  
  Total survival time in seconds
  
  revives integer
  
  Total teammate revives
  
  highestKills integer
  
  Highest kills in a single match
  
  damage integer
  
  Total damage dealt
  
  headshots integer
  
  Total headshots landed
  
  headshotKills integer
  
  Total kills with headshots
  
  knockDown integer
  
  Total enemy knockdowns
  
  pickUps integer
  
  Total items picked up
- quadStats object
  
  Statistics for a specific game mode
  
  Hide quadStats attributes Show quadStats attributes object
  
  accountId string
  
  Player's account ID
  
  gamesPlayed integer
  
  Total games played in this mode
  
  wins integer
  
  Total wins in this mode
  
  kills integer
  
  Total kills in this mode
  
  detailedStats object
  
  Detailed breakdown of statistics
  
  Hide detailedStats attributes Show detailedStats attributes object
  
  deaths integer
  
  Total deaths
  
  topNTimes integer
  
  Number of top placements
  
  distanceTravelled integer
  
  Total distance travelled in meters
  
  survivalTime integer
  
  Total survival time in seconds
  
  revives integer
  
  Total teammate revives
  
  highestKills integer
  
  Highest kills in a single match
  
  damage integer
  
  Total damage dealt
  
  headshots integer
  
  Total headshots landed
  
  headshotKills integer
  
  Total kills with headshots
  
  knockDown integer
  
  Total enemy knockdowns
  
  pickUps integer
  
  Total items picked up
400 application/json

Bad request - Invalid parameters or missing required fields
Hide response attributes Show response attributes object
- error string
  
  Error type or code
- message string
  
  Detailed error message
- status integer
  
  HTTP status code
401 application/json

Unauthorized - Invalid or missing API key
Hide response attributes Show response attributes object
- error string
  
  Error type or code
- message string
  
  Detailed error message
- status integer
  
  HTTP status code
429 application/json

Too many requests - Rate limit exceeded
Hide response attributes Show response attributes object
- error string
  
  Error type or code
- message string
  
  Detailed error message
- status integer
  
  HTTP status code
500 application/json

Internal server error - Something went wrong on our end
Hide response attributes Show response attributes object
- error string
  
  Error type or code
- message string
  
  Detailed error message
- status integer
  
  HTTP status code

GET /api/{region}

curl \
 --request GET 'https://stats.api.freefirecommunity.com/api/ind?uid=2129250963&key=YOUR_API_KEY'

Response examples (200)

{
  "success": true,
  "duoStats": {
    "accountId": "2129250963",
    "detailedStats": {}
  },
  "quadStats": {
    "wins": 3,
    "kills": 36,
    "accountId": "2129250963",
    "gamesPlayed": 13,
    "detailedStats": {
      "damage": 17872,
      "deaths": 10,
      "pickUps": 1536,
      "revives": 4,
      "headshots": 16,
      "knockDown": 42,
      "topNTimes": 6,
      "highestKills": 6,
      "survivalTime": 9210,
      "headshotKills": 5,
      "distanceTravelled": 60689
    }
  },
  "soloStats": {
    "kills": 7,
    "accountId": "2129250963",
    "gamesPlayed": 2,
    "detailedStats": {
      "damage": 1764,
      "deaths": 2,
      "pickUps": 146,
      "headshots": 1,
      "highestKills": 4,
      "survivalTime": 587,
      "headshotKills": 1,
      "distanceTravelled": 5309
    }
  }
}

Response examples (400)

{
  "error": "Bad Request",
  "status": 400,
  "message": "Invalid region code. Please use 'sg', 'ind', or 'br'"
}

Response examples (401)

{
  "error": "Unauthorized",
  "status": 401,
  "message": "Invalid API key. Please check your credentials or get a new key from http://developers.freefirecommunity.com/"
}

Response examples (429)

{
  "error": "Rate Limit Exceeded",
  "status": 429,
  "message": "Too many requests. Please slow down and try again later"
}

Response examples (500)

{
  "error": "Internal Server Error",
  "status": 500,
  "message": "An error occurred while processing your request. Please check your UID and region, then try again"
}