Get Player Wishlist

GET /api/{region}/wishlist

Retrieves the wishlist items for a specific player account.

This endpoint provides:

List of all wishlisted items
Item IDs for each wishlisted item
Timestamp when each item was added to the wishlist

Wishlist items can include:

Character skins and outfits
Weapon skins
Pets and pet skins
Emotes and bundles
Vehicle skins
And other in-game items

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 unique player User ID

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

Your API key from the developer portal

Responses

200 application/json

Wishlist successfully retrieved
Hide response attribute Show response attribute object
- wishlist_items array[object]
  
  Array of wishlisted items
  
  Hide wishlist_items attributes Show wishlist_items attributes object
  
  addTime string
  
  Timestamp when item was added (Unix)
  
  itemId string
  
  Unique item identifier
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

Player not found or wishlist is empty
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}/wishlist

curl \
 --request GET 'https://wishlist.api.freefirecommunity.com/api/ind/wishlist?uid=2180732447&key=YOUR_API_KEY'

Response examples (200)

{
  "wishlist_items": [
    {
      "itemId": "203000036",
      "addTime": "1710238335"
    },
    {
      "itemId": "203000981",
      "addTime": "1706079412"
    },
    {
      "itemId": "204033044",
      "addTime": "1706079412"
    },
    {
      "itemId": "205033048",
      "addTime": "1706079412"
    },
    {
      "itemId": "211000411",
      "addTime": "1706079412"
    },
    {
      "itemId": "902000003",
      "addTime": "1710238335"
    },
    {
      "itemId": "904090027",
      "addTime": "1707398570"
    },
    {
      "itemId": "907102508",
      "addTime": "1706079412"
    }
  ]
}

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": "Not found",
  "message": "Player not found or wishlist is empty"
}

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