API Introduction

Welcome to the ugiAPI API documentation. Our API allows developers to easily access Valorant player statistics, match history, MMR data, and regional leaderboards programmatically.

Base URL: https://api.ugilabs.com

Authentication

All API requests must be authenticated using an API Key. You can obtain your key from the Developer Panel.

Passing the API Key

We support two methods for passing your API key:

Option 1

Authorization Header (Preferred)

Authorization: Bearer VLAPI-XXXX-XXXX-XXXX

Option 2

Query Parameter

GET /v1/account/Player/Tag?api_key=VLAPI-XXXX-XXXX-XXXX

Rate Limiting

API usage is limited based on your plan. Rate limits are applied per API key.

Plan Type	Rate Limit	Intended Use
Standard	30 requests / min	Personal Projects
Premium	90 requests / min	Production Apps

Check the response headers X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset to monitor your usage.

Errors

The API uses standard HTTP response codes to indicate success or failure.

Code	Description
200	OK: Request successful.
400	Bad Request: Invalid parameters.
401	Unauthorized: Missing API key.
403	Forbidden: Invalid or inactive API key.
404	Not Found: Data not found for given parameters.
429	Too Many Requests: Rate limit exceeded.
500	Internal Server Error: Something went wrong on our end.
503	Service Unavailable: Riot API is down or maintenance.

Account Information

GET

URL: /v1/account/{name}/{tag}

Retrieves basic account details for a Valorant player using their Riot ID. Returns the PUUID, account level, player card, and title.

Parameters

Name	In	Type	Description
name	path	string	Riot ID Name
tag	path	string	Riot ID Tag (no #)

Request Example

curl -X GET "https://api.ugilabs.com/v1/account/TenZ/0505" \
     -H "Authorization: Bearer YOUR_API_KEY"

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.ugilabs.com/v1/account/TenZ/0505");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    "Authorization: Bearer YOUR_API_KEY"
));
$response = curl_exec($ch);
curl_close($ch);

import requests

url = "https://api.ugilabs.com/v1/account/TenZ/0505"
headers = {"Authorization": "Bearer YOUR_API_KEY"}

response = requests.get(url, headers=headers)
print(response.json())

fetch("https://api.ugilabs.com/v1/account/TenZ/0505", {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY"
  }
})
.then(response => response.json())
.then(data => console.log(data));

MMR / Rank

GET

URL: /v1/mmr/{region}/{name}/{tag}

Get current rank, competitive tier, and ELO points for a player.

Parameters

Name	In	Description
region	path	Region code (eu, na, ap, kr)
name	path	Riot ID Name
tag	path	Riot ID Tag (no #)

Response Example

{
  "status": 200,
  "data": {
    "name": "TenZ",
    "tag": "0505",
    "current_data": {
      "currenttier": 24,
      "currenttierpatched": "Immortal 1",
      "images": {
        "small": "https://.../small.png",
        "large": "https://.../large.png"
      },
      "elo": 2150,
      "mmr_change_to_last_game": 15
    }
  }
}

Match History

GET

URL: /v1/matches/{region}/{name}/{tag}

Get the last 5 matches for a player.

Query Parameters

size

Optional. Number of matches to return (default 5, max 20).

Match Details

GET

URL: /v1/match/{matchId}

Get detailed information about a specific match, including player stats, round outcomes, and economy.

Parameters

Name	In	Description
matchId	path	The UUID of the match

Leaderboard

GET

URL: /v1/leaderboard/{region}

Retrieve the top players for a specific region.

Query Parameters

size

Optional. Number of players to return (default 50).

start

Optional. Rank offset to start from (default 0).

actId

Optional. The Act ID to get the leaderboard for.

Game Content

GET

URL: /v1/content

Get static game content such as agents (characters), maps, chromas, and skins.

Query Parameters

locale

Optional. Language code (e.g., 'en-US', 'tr-TR'). Default 'en-US'.

Server Status

GET

URL: /v1/status/{region}

Get the current status of Valorant servers for a specific region.

API Playground

Test the API endpoints directly from your browser.

API Key

Endpoint

Method

GET

Response JSON