Get Game Assets and Images

GET /api/images

Retrieves in-game images and icons from the Free Fire asset database.

This endpoint allows you to fetch various game assets including:

  • Character avatars and skins
  • Weapon skins and icons
  • Items and equipment icons
  • Badges and banners
  • Pet images
  • And more

Simply provide the icon name to retrieve the corresponding image.

Query parameters

  • iconName string Required

    The name of the icon/image to retrieve from the game database

  • key string Required

    Your API key from the developer portal

Responses

  • 200

    Image successfully retrieved
  • 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
  • 404 application/json

    Image 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/images 
curl \
 --request GET 'https://images.freefirecommunity.com/api/images?iconName=Icon_avatar_hair_cos_eggday2021_headwear_blue&key=YOUR_API_KEY'
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 (404) 
{
  "error": "Image not found",
  "message": "The requested icon name does not exist in the database"
}
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"
}