Overview
The GetInfo endpoint checks a UID using the requested region and returns the upstream player lookup result as JSON.
Player information checks do not consume top-up request quota. Reasonable request handling and token security still apply.
Authentication
Send your UpBot token in the Authorization header. Bearer authentication is recommended.
HTTP header
Authorization: Bearer UPBOT_YOUR_TOKEN
A token query parameter is accepted for compatibility, but headers are safer because URLs may be stored in logs.
Query parameters
| PARAMETER | TYPE | REQUIRED | DESCRIPTION |
|---|---|---|---|
uid | string | YES | Free Fire Player ID to verify. |
region | string | YES | Provider-supported region code, such as BD. |
Request URL
GET
https://api.upbot.top/getinfo?uid=2444465764®ion=BD
Code examples
cURL
Shell
curl "https://api.upbot.top/getinfo?uid=2444465764®ion=BD" -H "Authorization: Bearer UPBOT_YOUR_TOKEN"
PHP
PHP 8+
<?php $url='https://api.upbot.top/getinfo?'.http_build_query(['uid'=>'2444465764','region'=>'BD']); $ch=curl_init($url); curl_setopt_array($ch,[CURLOPT_RETURNTRANSFER=>true,CURLOPT_HTTPHEADER=>['Authorization: Bearer UPBOT_YOUR_TOKEN'],CURLOPT_TIMEOUT=>15]); $result=json_decode(curl_exec($ch),true); curl_close($ch);
JavaScript (server-side)
Node.js
const url=new URL('https://api.upbot.top/getinfo');
url.search=new URLSearchParams({uid:'2444465764',region:'BD'});
const response=await fetch(url,{headers:{Authorization:'Bearer UPBOT_YOUR_TOKEN'}});
const result=await response.json();Responses
Player found
200 OK · representative
{"status":"success","uid":"2444465764","region":"BD","nickname":"Player Name"}The upstream provider controls the final field names and may include additional player information. Check status, then read the available nickname or player-name field.
Validation error
422 Unprocessable Content
{"status":"failed","message":"uid and region are required."}Authentication error
401 Unauthorized
{"status":"failed","message":"Invalid API token"}HTTP status codes
200Lookup response
The provider returned a player lookup result.
401Unauthorized
Token is missing or invalid.
403Forbidden
Token is disabled or expired.
405Wrong method
This endpoint accepts GET only.
422Validation error
uid or region is missing.
500Gateway error
An unexpected internal error occurred.