Get Player Wishlist

View as markdown
GET /wishlist
Api key auth

Retrieves the wishlist items for a specific player account.

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

    Wishlist successfully retrieved

    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 attribute Show response attribute object
    • wishlist_items array[object]
  • 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
  • 404

    Player not found or wishlist is empty

  • 429 application/json

    Too many requests - Rate limit exceeded

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

# Payload
{
  "wishlist_items": [
    {}
  ]
}
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
}