API Documentation

Integrate Free Fire likes into your application using coupon-based authentication.

Base URL
bnsgaming.site
Endpoints
POST /api/send Send likes to a Free Fire UID
Sends likes to the given Free Fire UID using the provided coupon. Likes are deducted from the coupon balance on each successful request.
Request Body — application/json
FieldTypeRequiredDescription
uidstringYesFree Fire player UID (numeric string)
couponstringYesValid coupon code — e.g. LIKES-XXXXXXXX
regionstringYesServer region code — e.g. IND  BD  ME
Code Examples

      
Response

      
 Success — success: true

      

        
successbooleanAlways true on a successful request

        
PlayerNicknamestringPlayer's in-game name in Free Fire

        
UIDnumberPlayer UID returned in numeric format

        
LikesbeforeCommandnumberTotal likes on the player's profile before the request

        
LikesafterCommandnumberTotal likes on the player's profile after the request

        
LikesUsednumberLikes actually consumed in this request (after minus before)

        
CouponRemainingnumberRemaining likes balance on the coupon after deduction

        
statusstringSUCCESS or TOKEN EXPIRED when balance hits zero

      

      
 Error — success: false

      

        
TOKEN EXPIREDCoupon has 0 likes remaining or the code does not exist

        
Region not availableThe provided region code is inactive or invalid

        
Missing fieldsOne or more of uid, coupon, region is absent from the request body

        
API Error. Try later.The upstream likes API is temporarily unavailable — retry after a moment

      

      

        
 Live Try — POST /api/send

        

        

        

        
        
Response

      

    

  

  

    

      GET
      /api/check-coupon
      Check coupon validity & balance
      
    

    

      
Verify whether a coupon code is valid and check how many likes remain. It is recommended to call this endpoint before sending likes.

      
Query Parameter

      

        
ParamTypeRequiredDescription

        
          
codestringYesCoupon code to check — append as ?code=LIKES-XXXXXXXX

        
      

      
Code Examples

      

        
        
        
        
        
      

      

      
Response

      
 Valid coupon

      

        
validbooleantrue — coupon exists and has balance

        
remainingLikesnumberLikes remaining on the coupon

        
messagestringe.g. 250 likes remaining

      

      
 Invalid / expired coupon

      

        
validbooleanfalse — coupon not found or balance is zero

        
messagestringReason string e.g. Invalid coupon or Coupon expired (0 likes left)