Get Player Information

GET /api/data

Retrieves comprehensive player information including profile data, rankings, badges, clan membership, pet information, and more.

This endpoint provides detailed account information such as:

  • Basic account details (nickname, level, rank, likes)
  • Badge and banner information
  • Clan/guild membership details
  • Pet information and skills
  • Equipped items and skins
  • Credit score and diamond cost
  • Season statistics

Note: Make sure to use the correct region code that matches the player's account region.

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}$.

  • key string Required

    Your API key from the developer portal

Responses

  • 200 application/json

    Successfully retrieved player information

    Hide response attributes Show response attributes object
    • basicInfo object

      Basic player account information

      Hide basicInfo attributes Show basicInfo attributes object
      • accountId string

        Unique account identifier

      • nickname string

        Player's display name

      • level integer

        Current player level

      • exp string

        Total experience points

      • rank integer

        Current Battle Royale rank

      • maxRank integer

        Highest Battle Royale rank achieved

      • rankingPoints integer

        Current Battle Royale ranking points

      • csRank integer

        Current Clash Squad rank

      • csMaxRank integer

        Highest Clash Squad rank achieved

      • csRankingPoints integer

        Current Clash Squad ranking points

      • liked integer

        Total profile likes received

      • badgeId string

        Equipped badge ID

      • badgeCnt integer

        Total badges owned

      • bannerId string

        Equipped banner ID

      • title string

        Equipped title ID

      • headPic string

        Profile picture/avatar ID

      • region string

        Player's region

      • createAt string

        Account creation timestamp (Unix)

      • lastLoginAt string

        Last login timestamp (Unix)

      • seasonId integer

        Current season ID

      • releaseVersion string

        Game version

    • clanBasicInfo object

      Player's clan/guild information

      Hide clanBasicInfo attributes Show clanBasicInfo attributes object
      • clanId string

        Clan unique identifier

      • clanName string

        Clan name

      • captainId string

        Clan captain's account ID

      • clanLevel integer

        Clan level

      • memberNum integer

        Current number of clan members

      • capacity integer

        Maximum clan capacity

    • captainBasicInfo object

      Clan captain's basic information

    • petInfo object

      Player's equipped pet information

      Hide petInfo attributes Show petInfo attributes object
      • id string

        Pet ID

      • level integer

        Pet level

      • exp integer

        Pet experience points

      • isSelected boolean

        Whether this pet is currently selected

      • selectedSkillId string

        Currently selected pet skill ID

      • skinId string

        Equipped pet skin ID

    • creditScoreInfo object

      Player's credit score information

      Hide creditScoreInfo attributes Show creditScoreInfo attributes object
      • creditScore integer

        Current credit score (0-100)

      • rewardState integer

        Reward state indicator

      • rewardType integer

        Type of reward available

    • profileInfo object

      Player's profile customization

    • socialInfo object

      Player's social information

      Hide socialInfo attributes Show socialInfo attributes object
      • accountId string

        Account ID

      • signature string

        Player's bio/signature

  • 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/data
curl \
 --request GET 'https://api.freefirecommunity.com/api/data?region=ind&uid=2180732447&key=YOUR_API_KEY'
Response examples (200)
{
  "petInfo": {
    "id": "1300000119",
    "exp": 1239,
    "level": 5,
    "skinId": "1310000194",
    "isSelected": true,
    "selectedSkillId": "1315000007"
  },
  "basicInfo": {
    "exp": "1090123",
    "rank": 306,
    "level": 61,
    "liked": 4902,
    "pinId": 910040001,
    "title": "904490053",
    "csRank": 301,
    "region": "IND",
    "badgeId": "1001000089",
    "headPic": "902000226",
    "maxRank": 306,
    "bannerId": "901000159",
    "createAt": "1548046117",
    "nickname": "FFC•ASHQKING",
    "seasonId": 47,
    "accountId": "665951869",
    "csMaxRank": 301,
    "showBrRank": true,
    "accountType": 1,
    "lastLoginAt": "1758016249",
    "rankingPoints": 1547,
    "accountPrefers": {
      "brPregameShowChoices": [
        1
      ]
    },
    "releaseVersion": "OB50",
    "weaponSkinShows": [
      "907193003",
      "912000005"
    ],
    "externalIconInfo": {
      "status": 1,
      "showType": 1
    },
    "selectOccupations": [
      {
        "type": 2,
        "modeId": 1,
        "details": {
          "key1": 3,
          "key4": 1,
          "key5": 1
        },
        "seasonId": 47
      },
      {
        "type": 6,
        "modeId": 15,
        "details": {
          "key1": 1,
          "key4": 1,
          "key5": 1
        },
        "seasonId": 34
      }
    ],
    "primePrivilegeDetail": {
      "accountId": "665951869",
      "primeLevel": 3,
      "privilegeIdList": [
        16,
        20,
        21,
        8,
        10,
        11,
        19
      ]
    }
  },
  "socialInfo": {
    "accountId": "665951869",
    "signature": "I love free fire"
  },
  "profileInfo": {
    "clothes": [
      "214044002",
      "211001320",
      "203044008",
      "205044008",
      "204044008",
      "211001271"
    ],
    "avatarId": "101000007",
    "isSelected": true,
    "equipedSkills": [
      {
        "skillId": 505
      },
      {
        "slotId": 1,
        "skillId": 4206
      },
      {
        "slotId": 2,
        "skillId": 4905
      },
      {
        "slotId": 3,
        "skillId": 1204
      }
    ],
    "isSelectedAwaken": true
  },
  "clanBasicInfo": {
    "clanId": "3041861373",
    "capacity": 40,
    "clanName": "ƝEOƝ»Ᏻᴀɴɢ×͜×",
    "captainId": "973498167",
    "clanLevel": 3,
    "memberNum": 37
  },
  "diamondCostRes": {
    "diamondCost": 390
  },
  "creditScoreInfo": {
    "rewardType": 2,
    "creditScore": 100,
    "rewardEndAt": "1759512407",
    "rewardState": 1,
    "rewardStartAt": "1759253207"
  },
  "captainBasicInfo": {
    "exp": "3479945",
    "rank": 326,
    "level": 72,
    "liked": 17672,
    "title": "904090026",
    "csRank": 321,
    "region": "IND",
    "badgeId": "1001000089",
    "headPic": "902039010",
    "maxRank": 326,
    "badgeCnt": 20,
    "bannerId": "901039009",
    "createAt": "1557221937",
    "nickname": "₦₲ㅤᏃᎬᎡᎾX̸×͜×",
    "seasonId": 47,
    "accountId": "973498167",
    "csMaxRank": 321,
    "showBrRank": true,
    "showCsRank": true,
    "accountType": 1,
    "lastLoginAt": "1759385257",
    "extraField_77": 1602,
    "extraField_78": 1,
    "rankingPoints": 6309,
    "accountPrefers": {},
    "releaseVersion": "OB50",
    "csRankingPoints": 91,
    "weaponSkinShows": [
      "907192604",
      "912000007"
    ],
    "externalIconInfo": {
      "status": 1,
      "showType": 1
    },
    "selectOccupations": [
      {
        "type": 2,
        "modeId": 1,
        "details": {
          "key1": 3,
          "key2": 705,
          "key3": 354,
          "key4": 10,
          "key5": 1
        },
        "seasonId": 47
      },
      {
        "type": 6,
        "modeId": 15,
        "details": {
          "key1": 3,
          "key2": 106,
          "key3": 85,
          "key4": 4,
          "key5": 1
        },
        "seasonId": 34
      },
      {
        "type": 16,
        "modeId": 15,
        "details": {
          "key1": 3,
          "key2": 71,
          "key3": 51,
          "key4": 2,
          "key5": 1
        },
        "seasonId": 1
      }
    ],
    "primePrivilegeDetail": {
      "accountId": "973498167",
      "primeLevel": 3,
      "privilegeIdList": [
        20,
        21,
        8,
        10,
        11,
        19,
        16
      ]
    }
  }
}
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"
}