Check Player Ban Status

GET /bancheck
Api key auth

Checks if a Free Fire player account is currently banned or has an active ban period.

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

  • uid string Required

    The unique player User ID (10-12 digits)

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

  • lang string

    Language for the response

    Values are en, ar, es, id, pt, ru, or vi. Default value is en.

Responses

  • 200 application/json

    Ban check completed successfully

    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

    Hide response attributes Show response attributes object
    • status string
    • data object
      Hide data attributes Show data attributes object
      • is_banned integer

        Values are 0 or 1.

      • period integer
  • 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
  • 429 application/json

    Too many requests - Rate limit exceeded

    Hide response attributes Show response attributes object
    • error string
    • message string
    • status integer
GET /bancheck 
curl \
 --request GET 'https://developers.freefirecommunity.com/api/v1/bancheck?uid=665951869' \
 --header "x-api-key: ffc_1234567890_abcdefghijk"
Response examples (200) 
# Headers
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45

# Payload
{
  "status": "string",
  "data": {
    "is_banned": 0,
    "period": 42
  }
}
Response examples (400) 
{
  "error": "string",
  "message": "string",
  "status": 42
}
Response examples (401) 
{
  "error": "string",
  "message": "string",
  "status": 42
}
Response examples (429) 
{
  "error": "string",
  "message": "string",
  "status": 42
}