Get Player Information

GET /info

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.

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 information
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
- basicInfo object
  
  Basic player account information
- clanBasicInfo object
  
  Player's clan information
- petInfo object
  
  Player's equipped pet information
- creditScoreInfo object
  
  Player's credit score information
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 /info

curl -X GET "https://developers.freefirecommunity.com/api/v1/info?region=ind&uid=665951869" \
  -H "x-api-key: your_api_key_here"

curl -X GET "https://developers.freefirecommunity.com/api/v1/info?region=ind&uid=665951869&key=your_api_key_here"

const response = await fetch(
  'https://developers.freefirecommunity.com/api/v1/info?region=ind&uid=665951869',
  {
    headers: {
      'x-api-key': 'your_api_key_here'
    }
  }
);
const data = await response.json();

const response = await fetch(
  'https://developers.freefirecommunity.com/api/v1/info?region=ind&uid=665951869&key=your_api_key_here'
);
const data = await response.json();

import requests

headers = {'x-api-key': 'your_api_key_here'}
params = {'region': 'ind', 'uid': '665951869'}

response = requests.get(
    'https://developers.freefirecommunity.com/api/v1/info',
    headers=headers,
    params=params
)
data = response.json()

import requests

params = {
    'region': 'ind',
    'uid': '665951869',
    'key': 'your_api_key_here'
}

response = requests.get(
    'https://developers.freefirecommunity.com/api/v1/info',
    params=params
)
data = response.json()

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

Response examples (200)

{
  "basicInfo": {
    "rank": 306,
    "level": 61,
    "liked": 4902,
    "nickname": "FFC•ASHQKING",
    "accountId": "665951869"
  },
  "clanBasicInfo": {
    "clanName": "ƝEOƝ»Ᏻᴀɴɢ×͜×",
    "memberNum": 37
  }
}

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
}