Get Guild/Clan Information

GET /api/{region}/guild

Retrieves comprehensive guild/clan information including member details, activity points, and ranking data.

Important Requirements:

You need a guest account that is a member of the target guild
The guest account credentials (UID and password) are required for authentication
The guest account must be in the same region as the guild

This endpoint provides:

Guild name, level, and member count
Captain/leader information
Activity and ranking points
Guild capacity and creation date
And more

Path parameters

region string Required
The region code:
- sg: Singapore region
- ind: India region
- br: Brazil region
Values are sg, ind, or br.

Query parameters

uid string Required

The guest account UID (must be a member of the target guild)

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

The guest account password
clanid string Required

The target guild/clan ID
key string Required

Your API key from the developer portal

Responses

200 application/json

Guild information successfully retrieved
Hide response attribute Show response attribute object
- clan_info object
  
  Hide clan_info attributes Show clan_info attributes object
  
  clanId string
  
  Unique clan identifier
  
  clanName string
  
  Clan name
  
  createAt string
  
  Clan creation timestamp (Unix)
  
  captainId string
  
  Clan captain's account ID
  
  clanLevel integer
  
  Current clan level
  
  capacity integer
  
  Maximum member capacity
  
  memberNum integer
  
  Current number of members
  
  region string
  
  Clan's region
  
  slogan string
  
  Clan slogan/description
  
  rankingPoints integer
  
  Clan ranking points
  
  activityPoints string
  
  Total activity points
  
  weeklyActivityPoints string
  
  Weekly activity points
  
  lastUpdateAt string
  
  Last update timestamp (Unix)
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
403 application/json

Access denied
Hide response attributes Show response attributes object
- error string
  
  Error type or code
- message string
  
  Detailed error message
- status integer
  
  HTTP status code
404 application/json

Guild not found
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}/guild

curl \
 --request GET 'https://guild-info.api.freefirecommunity.com/api/br/guild?uid=12345678&password=ABCD1234EFGH5678XYZ90&clanid=61207059&key=YOUR_API_KEY'

Response examples (200)

{
  "clan_info": {
    "clanId": "12345678",
    "region": "BR",
    "slogan": "Clan Signature",
    "capacity": 55,
    "clanName": "My Clan",
    "createAt": "1536019119",
    "captainId": "194410341",
    "clanLevel": 7,
    "memberNum": 46,
    "lastUpdateAt": "1750169275",
    "rankingPoints": 23,
    "activityPoints": "3906928",
    "weeklyActivityPoints": "54827"
  }
}

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 (403)

{
  "error": "Access denied",
  "message": "The guest account is not a member of the specified guild or credentials are invalid"
}

Response examples (404)

{
  "error": "Guild not found",
  "message": "The specified guild ID does not exist"
}

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"
}