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	20 requests / min	Personal Projects
Advanced	60 requests / min	Discord Bots & Growing Projects
Premium	300 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.

GET

Account Information

/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
name	path	Riot ID Name
tag	path	Riot ID Tag (no #)

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, [
    "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(res => res.json())
.then(data => console.log(data));

Try It

Response

GET

Account Information by PUUID

/v1/by-puuid/account/{puuid}

Retrieves basic account details for a Valorant player using their unique PUUID.

Parameters

Name	In	Type
puuid	path	The unique PUUID of the player

curl -X GET "https://api.ugilabs.com/v1/by-puuid/account/4a82a0d1-..." \
  -H "Authorization: Bearer YOUR_API_KEY"

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.ugilabs.com/v1/by-puuid/account/4a82a0d1-...");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer YOUR_API_KEY"
]);
$response = curl_exec($ch);
curl_close($ch);

import requests

url = "https://api.ugilabs.com/v1/by-puuid/account/4a82a0d1-..."
headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(url, headers=headers)
print(response.json())

fetch("https://api.ugilabs.com/v1/by-puuid/account/4a82a0d1-...", {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY"
  }
})
.then(res => res.json())
.then(data => console.log(data));

Try It

Response

GET

MMR / Rank

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

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

Parameters

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

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

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

import requests

url = "https://api.ugilabs.com/v1/mmr/eu/TenZ/0505"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(url, headers=headers)
print(response.json())

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

Try It

Response

GET

MMR History

/v1/mmr-history/{region}/{name}/{tag}

Retrieves the history of competitive matchmaking rank changes for a player.

Parameters

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

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

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.ugilabs.com/v1/mmr-history/eu/TenZ/0505");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer YOUR_API_KEY"
]);
$response = curl_exec($ch);
curl_close($ch);

import requests

url = "https://api.ugilabs.com/v1/mmr-history/eu/TenZ/0505"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(url, headers=headers)
print(response.json())

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

Try It

Response

GET

MMR / Rank by PUUID

/v1/by-puuid/mmr/{region}/{puuid}

Get current rank, competitive tier, and ELO points for a player using their unique PUUID.

Parameters

Name	In	Type
region	path	Region code (eu, na, ap, kr)
puuid	path	The unique PUUID of the player

curl -X GET "https://api.ugilabs.com/v1/by-puuid/mmr/eu/4a82a0d1-..." \
  -H "Authorization: Bearer YOUR_API_KEY"

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.ugilabs.com/v1/by-puuid/mmr/eu/4a82a0d1-...");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer YOUR_API_KEY"
]);
$response = curl_exec($ch);
curl_close($ch);

import requests

url = "https://api.ugilabs.com/v1/by-puuid/mmr/eu/4a82a0d1-..."
headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(url, headers=headers)
print(response.json())

fetch("https://api.ugilabs.com/v1/by-puuid/mmr/eu/4a82a0d1-...", {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY"
  }
})
.then(res => res.json())
.then(data => console.log(data));

Try It

Response

GET

Match History

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

Get the last 5 matches for a player.

Parameters

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

Query Parameters

size

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

curl -X GET "https://api.ugilabs.com/v1/matches/eu/TenZ/0505?size=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.ugilabs.com/v1/matches/eu/TenZ/0505?size=5");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer YOUR_API_KEY"
]);
$response = curl_exec($ch);
curl_close($ch);

import requests

url = "https://api.ugilabs.com/v1/matches/eu/TenZ/0505"
params = {"size": 5}
headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(url, headers=headers, params=params)
print(response.json())

fetch("https://api.ugilabs.com/v1/matches/eu/TenZ/0505?size=5", {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY"
  }
})
.then(res => res.json())
.then(data => console.log(data));

Try It

Response

GET

Match History by PUUID

/v1/by-puuid/matches/{region}/{puuid}

Get match history for a player using their unique PUUID.

Parameters

Name	In	Type
region	path	Region code (eu, na, ap, kr)
puuid	path	The unique PUUID of the player

Query Parameters

size

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

curl -X GET "https://api.ugilabs.com/v1/by-puuid/matches/eu/4a82a0d1-...?size=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.ugilabs.com/v1/by-puuid/matches/eu/4a82a0d1-...?size=5");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer YOUR_API_KEY"
]);
$response = curl_exec($ch);
curl_close($ch);

import requests

url = "https://api.ugilabs.com/v1/by-puuid/matches/eu/4a82a0d1-..."
params = {"size": 5}
headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(url, headers=headers, params=params)
print(response.json())

fetch("https://api.ugilabs.com/v1/by-puuid/matches/eu/4a82a0d1-...?size=5", {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY"
  }
})
.then(res => res.json())
.then(data => console.log(data));

Try It

Response

GET

Match Details

/v1/match/{matchId}

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

Parameters

Name	In	Type
matchId	path	The UUID of the match

curl -X GET "https://api.ugilabs.com/v1/match/e20f..." \
  -H "Authorization: Bearer YOUR_API_KEY"

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.ugilabs.com/v1/match/e20f...");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer YOUR_API_KEY"
]);
$response = curl_exec($ch);
curl_close($ch);

import requests

url = "https://api.ugilabs.com/v1/match/e20f..."
headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(url, headers=headers)
print(response.json())

fetch("https://api.ugilabs.com/v1/match/e20f...", {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY"
  }
})
.then(res => res.json())
.then(data => console.log(data));

Try It

Response

GET

Leaderboard

/v1/leaderboard/{region}

Retrieve the top players for a specific region.

Parameters

Name	In	Type
region	path	Region code (eu, na, ap, kr)

Query Parameters

size

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

start

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

act

Optional. The Act ID to get the leaderboard for.

curl -X GET "https://api.ugilabs.com/v1/leaderboard/eu?size=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.ugilabs.com/v1/leaderboard/eu?size=50");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer YOUR_API_KEY"
]);
$response = curl_exec($ch);
curl_close($ch);

import requests

url = "https://api.ugilabs.com/v1/leaderboard/eu"
params = {"size": 50}
headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(url, headers=headers, params=params)
print(response.json())

fetch("https://api.ugilabs.com/v1/leaderboard/eu?size=50", {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY"
  }
})
.then(res => res.json())
.then(data => console.log(data));

Try It

Response

GET

Game Content

/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'.

curl -X GET "https://api.ugilabs.com/v1/content?locale=en-US" \
  -H "Authorization: Bearer YOUR_API_KEY"

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.ugilabs.com/v1/content?locale=en-US");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer YOUR_API_KEY"
]);
$response = curl_exec($ch);
curl_close($ch);

import requests

url = "https://api.ugilabs.com/v1/content"
params = {"locale": "en-US"}
headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(url, headers=headers, params=params)
print(response.json())

fetch("https://api.ugilabs.com/v1/content?locale=en-US", {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY"
  }
})
.then(res => res.json())
.then(data => console.log(data));

Try It

Response

GET

Server Status

/v1/status/{region}

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

Parameters

Name	In	Type
region	path	Region code (eu, na, ap, kr)

curl -X GET "https://api.ugilabs.com/v1/status/eu" \
  -H "Authorization: Bearer YOUR_API_KEY"

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.ugilabs.com/v1/status/eu");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer YOUR_API_KEY"
]);
$response = curl_exec($ch);
curl_close($ch);

import requests

url = "https://api.ugilabs.com/v1/status/eu"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(url, headers=headers)
print(response.json())

fetch("https://api.ugilabs.com/v1/status/eu", {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY"
  }
})
.then(res => res.json())
.then(data => console.log(data));

Try It

Response

API Playground

Test the API endpoints directly from your browser.

API Key

Endpoint

Method

GET

Response JSON