{"openapi":"3.1.0","info":{"title":"VALORANT API","version":"1.0.0","description":"VALORANT game content as an API, powered by valorant-api.com. Get every playable agent with their role, abilities and lore, all maps with their callouts and coordinates, the full weapon roster with costs, fire rate, magazine size and head/body/leg damage (plus the list of skins per gun), the current competitive rank tiers from Iron to Radiant with their colours, and all playable game modes. Look up a single agent, map or weapon by name, or filter agents by role (Duelist, Initiator, Controller, Sentinel) and weapons by category. Game data is served from a static CDN, so it is fast and rock-solid under load. Perfect for VALORANT companion apps, agent and weapon guides, rank trackers, Discord bots, tier lists and fan sites. No accounts, no upstream key. Not affiliated with Riot Games.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/valorant-api","description":"oanor gateway"}],"tags":[{"name":"Agents"},{"name":"Maps"},{"name":"Weapons"},{"name":"Reference"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/agents":{"get":{"operationId":"get_v1_agents","tags":["Agents"],"summary":"Agents (all, by name, or by role)","description":"","parameters":[{"name":"name","in":"query","required":false,"description":"Agent name","schema":{"type":"string"},"example":"Jett"},{"name":"role","in":"query","required":false,"description":"Duelist|Initiator|Controller|Sentinel","schema":{"type":"string"},"example":"Duelist"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"agent":{"icon":"https://media.valorant-api.com/agents/add6443a-41bd-e414-f6ad-e58d267f4e95/displayicon.png","name":"Jett","role":"Duelist","uuid":"add6443a-41bd-e414-f6ad-e58d267f4e95","portrait":"https://media.valorant-api.com/agents/add6443a-41bd-e414-f6ad-e58d267f4e95/fullportrait.png","abilities":[{"name":"Updraft","slot":"Ability1","description":"INSTANTLY propel Jett high into the air."},{"name":"Tailwind","slot":"Ability2","description":"ACTIVATE to prepare a gust of wind for a limited time. RE-USE the wind to propel Jett in the direction she is moving. If Jett is standing still, she propels forward. Tailwind charge resets every two kills."},{"name":"Cloudburst","slot":"Grenade","description":"INSTANTLY throw a projectile that expands into a brief vision-blocking cloud on impact with a surface. HOLD the ability key to curve the smoke in the direction of your crosshair."},{"name":"Blade Storm","slot":"Ultimate","description":"EQUIP a set of highly accurate throwing knives. FIRE to throw a single knife and recharge knives on a kill. ALT FIRE to throw all remaining daggers but does not recharge on a kill."},{"name":"Drift","slot":"Passive","description":"Holding the jump button while falling allows you to glide through the air."}],"background":"https://media.valorant-api.com/agents/add6443a-41bd-e414-f6ad-e58d267f4e95/background.png","description":"Representing her home country of South Korea, Jett's agile and evasive fighting style lets her take risks no one else can. She runs circles around every skirmish, cutting enemies up before they even know what hit them.","role_description":"Duelists are self-sufficient fraggers who their team expects, through abilities and skills, to get high frags and seek out engagements first."}},"meta":{"timestamp":"2026-06-01T00:04:03.280Z","request_id":"4925c811-f3af-4fc1-b0f3-0f4d94575091"},"status":"ok","message":"Agents retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/maps":{"get":{"operationId":"get_v1_maps","tags":["Maps"],"summary":"Maps (all or by name)","description":"","parameters":[{"name":"name","in":"query","required":false,"description":"Map name","schema":{"type":"string"},"example":"Bind"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"map":{"name":"Bind","uuid":"2c9d57ec-4431-9c5e-2939-8f9ef6dd5cba","splash":"https://media.valorant-api.com/maps/2c9d57ec-4431-9c5e-2939-8f9ef6dd5cba/splash.png","minimap":"https://media.valorant-api.com/maps/2c9d57ec-4431-9c5e-2939-8f9ef6dd5cba/displayicon.png","callouts":24,"list_icon":"https://media.valorant-api.com/maps/2c9d57ec-4431-9c5e-2939-8f9ef6dd5cba/listviewicon.png","coordinates":"34°2'A'N,6°51'Z'W","description":"A/B Sites"}},"meta":{"timestamp":"2026-06-01T00:04:03.384Z","request_id":"86d91756-0bf7-4d05-8416-a1d834c63af4"},"status":"ok","message":"Maps retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/weapons":{"get":{"operationId":"get_v1_weapons","tags":["Weapons"],"summary":"Weapons (all, by name, or by category)","description":"","parameters":[{"name":"name","in":"query","required":false,"description":"Weapon name","schema":{"type":"string"},"example":"Vandal"},{"name":"category","in":"query","required":false,"description":"Category filter","schema":{"type":"string"},"example":"Rifle"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"weapon":{"cost":2900,"icon":"https://media.valorant-api.com/weapons/9c82e19d-4575-0200-1a81-3eacf00cf872/displayicon.png","name":"Vandal","uuid":"9c82e19d-4575-0200-1a81-3eacf00cf872","skins":["Immortalized Vandal","RGX 11z Pro Vandal","Altitude Vandal","VALORANT GO! Vol. 2 Vandal","Divergence Vandal","Araxys Vandal","Neptune Vandal","Aristocrat Vandal","Gaia's Vengeance Vandal","MK.VII Liberty Vandal","Endeavour Vandal","ATLAS // CMD Vandal","Champions 2021 Vandal","Champions 2023 Vandal","Origin Vandal","Comet Vandal","Phaseguard Vandal","Starlit Odyssey Vandal","Glitchpop Vandal","ChronoVoid Vandal","Prelude to Chaos Vandal","Elderflame Vandal","Imperium Vandal","Singularity Vandal","ORA by OneTap Vandal","Sarmad Vandal","Nitro Vandal","Hivemind Vandal","Venturi Vandal","Forsaken Vandal","Team Ace Vandal","Heartstopper Vandal","Superset Vandal","Dolmir's Revenge Vandal","Ruin Vandal",".EXE Vandal",".SYS Vandal","Primordium Vandal","EX.O Vandal","Horizon Vandal","Prime Vandal","XERØFANG Vandal ","Avalanche Vandal","Bubble Pop Vandal","Guardrail Vandal","Black.Market Vandal","Prism II Vandal","K/TAC Vandal","Solarstride Vandal","Aemondir Vandal","Smite Vandal","Monstrocity Vandal","Nunca Olvidados Vandal","Luxe Vandal","Arcane Vandal","Magepunk Vandal","Champions 2025 Vandal","Minima Vandal","Valiant Hero Vandal","Overdrive Vandal","Silvanus Vandal","Crimsonbeast Vandal","Kuronami Vandal","Belaflaire Vandal","Ion Vandal","Oni Vandal","SilkLeaf Vandal","Cryostasis Vandal","Luna Vandal","Sensation Vandal","Random Favorite Skin","Orion Vandal","Rogue Vandal","Blackthorn Vandal","Sentinels of Light Vandal","Sakura Vandal","Schema Vandal","Keys to Elysium Vandal","Holo Meridian Vandal","Lycan's Bane Vandal","Transition Vandal","Byteshift Vandal","Torque Vandal","Reaver Vandal","Tethered Realms Vandal","Cavalier Vandal","Paceline Vandal","Titanmail Vandal","Mystbloom Vandal","Standard Vandal","Evori Dreamwings Vandal","CYRAX Vandal","NO LIMITS Vandal","Sandswept Vandal","Depths Vandal","Wonderstallion Vandal","Ego Vandal","Holomoku Vandal","Wasteland Vandal","SplashX Vandal","Winterwunderland Vandal","Storm Maw Vandal"],"damage":{"leg":34,"body":40,"head":160,"range_m":"0-50"},"category":"Assault Rifles","magazine":25,"fire_rate":9.75,"skin_count":102,"equip_seconds":1,"reload_seconds":2.5,"wall_penetration":"Medium"}},"meta":{"timestamp":"2026-06-01T00:04:03.536Z","request_id":"4f5c6223-ad07-4a37-98a4-46fa595d7d43"},"status":"ok","message":"Weapons retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/gamemodes":{"get":{"operationId":"get_v1_gamemodes","tags":["Reference"],"summary":"Playable game modes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":16,"gamemodes":[{"icon":"https://media.valorant-api.com/gamemodes/1cd8901f-47af-49cb-d758-e2afd0eb2a39/displayicon.png","name":"All Random One Site","uuid":"1cd8901f-47af-49cb-d758-e2afd0eb2a39","duration":"10-15 MINS","description":"LIMITED TIME: Plant/defuse mode. One site, random agents, free loadouts, way more ultimates. First to 5 wins.","allows_timeouts":false},{"icon":"https://media.valorant-api.com/gamemodes/96bd3920-4f36-d026-2b28-c683eb0bcac5/displayicon.png","name":"Standard","uuid":"96bd3920-4f36-d026-2b28-c683eb0bcac5","duration":"30-40 MINS","description":"Plant/defuse mode. Unranked matches, full map pool, attack and defend, classic gameplay. First to 13 wins.","allows_timeouts":true},{"icon":"https://media.valorant-api.com/gamemodes/a8790ec5-4237-f2f0-e93b-08a8e89865b2/displayicon.png","name":"Deathmatch","uuid":"a8790ec5-4237-f2f0-e93b-08a8e89865b2","duration":"7-9 MINS","description":"Elimination mode. All gunplay, respawn instantly, no abilities, no economy. First to 40 kills wins.","allows_timeouts":false},{"icon":"https://media.valorant-api.com/gamemodes/1a4a3fd5-4966-62cb-7fe4-15b0317f5c80/displayicon.png","name":"Knockout","uuid":"1a4a3fd5-4966-62cb-7fe4-15b0317f5c80","duration":"10-15 MINS","description":"LIMITED TIME: Elimination mode. Round-based, takedowns revive teammates, push the line, fight together. First to 4 rounds wins.","allows_timeouts":true},{"icon":"https://media.valorant-api.com/gamemodes/d2d0f229-4514-517a-b10a-aaa0ef0d4a67/displayicon.png","name":"Bot Match","uuid":"d2d0f229-4514-517a-b10a-aaa0ef0d4a67","allows_timeouts":false},{"icon":"https://media.valorant-api.com/gamemodes/a4ed6518-4741-6dcb-35bd-f884aecdc859/displayicon.png","name":"Escalation","uuid":"a4ed6518-4741-6dcb-35bd-f884aecdc859","duration":"7-9 MINS","description":"Elimination mode. Team arsenal, weapon progression, eliminate to advance, race to finish. First to complete wins.","allows_timeouts":false},{"icon":"https://media.valorant-api.com/gamemodes/e086db66-47fd-e791-ca81-06a645ac7661/displayicon.png","name":"Team Deathmatch","uuid":"e086db66-47fd-e791-ca81-06a645ac7661","duration":"8-10 MINS","description":"Elimination mode. Two teams, unique maps, recharging abilities, constant action. First to 100 kills wins.","allows_timeouts":false},{"name":"Basic Training","uuid":"2b470a47-40e0-ad02-73b4-7f8585fa108c","description":"Replay the tutorial!","allows_timeouts":false},{"name":"Onboarding","uuid":"d2b4e425-4cab-8d95-eb26-bb9b444551dc","allows_timeouts":false},{"icon":"https://media.valorant-api.com/gamemodes/4744698a-4513-dc96-9c22-a9aa437e4a58/displayicon.png","name":"Replication","uuid":"4744698a-4513-dc96-9c22-a9aa437e4a58","duration":"10-15 MINS","description":"Same rules as unrated, but all players on the same team are the same agent. Set credits per round, first to 5 rounds wins.","allows_timeouts":false},{"icon":"https://media.valorant-api.com/gamemodes/e921d1e6-416b-c31f-1291-74930c330b7b/displayicon.png","name":"Spike Rush","uuid":"e921d1e6-416b-c31f-1291-74930c330b7b","duration":"8-12 MINS","description":"Plant/defuse mode. Random weapons, powerup orbs, five spikes, shorter rounds. First to 4 wins.","allows_timeouts":false},{"icon":"https://media.valorant-api.com/gamemodes/e2dc3878-4fe5-d132-28f8-3d8c259efcc6/displayicon.png","name":"The Range","uuid":"e2dc3878-4fe5-d132-28f8-3d8c259efcc6","description":"Warm up with all weapons and agents unlocked!","allows_timeouts":false},{"icon":"https://media.valorant-api.com/gamemodes/0e9805d8-4af6-5ffb-f467-55806a6bc484/displayicon.png","name":"Skirmish","uuid":"0e9805d8-4af6-5ffb-f467-55806a6bc484","duration":"5-10 MINS","description":"Fast elimination battles on small-scale maps, customizable with cheats. First to 10 rounds wins.","allows_timeouts":false},{"icon":"https://media.valorant-api.com/gamemodes/d08c45fe-4415-edcf-65a3-45885cc4349b/displayicon.png","name":"Skirmish: Ascension","uuid":"d08c45fe-4415-edcf-65a3-45885cc4349b","duration":"5-10 MINS","description":"Fast elimination battles on small-scale maps, customizable with cheats. First to 10 rounds wins.","allows_timeouts":false},{"icon":"https://media.valorant-api.com/gamemodes/57038d6d-49b1-3a74-c5ef-3395d9f23a97/displayicon.png","name":"Snowball Fight","uuid":"57038d6d-49b1-3a74-c5ef-3395d9f23a97","duration":"5-7 MINS","description":"Launch snowballs, open presents, and ice skate in this fast festive 5v5 team deathmatch. No abilities, first to 50 kills wins.","allows_timeouts":false},{"icon":"https://media.valorant-api.com/gamemodes/5d0f264b-4ebe-cc63-c147-809e1374484b/displayicon.png","name":"Swiftplay","uuid":"5d0f264b-4ebe-cc63-c147-809e1374484b","duration":"10-15 MIN","description":"Plant/defuse mode. Quicker matches, same core rules, same objectives, accelerated economy. First to 5 wins.","allows_timeouts":false}]},"meta":{"timestamp":"2026-06-01T00:04:03.623Z","request_id":"6b9c3143-6e11-4081-80ab-65100b06aa14"},"status":"ok","message":"Game modes retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/tiers":{"get":{"operationId":"get_v1_tiers","tags":["Reference"],"summary":"Competitive rank tiers","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":25,"tiers":[{"icon":"https://media.valorant-api.com/competitivetiers/03621f52-342b-cf4e-4f86-9350a49c6d04/3/largeicon.png","name":"IRON 1","tier":3,"color":"4f514fff","division":"IRON"},{"icon":"https://media.valorant-api.com/competitivetiers/03621f52-342b-cf4e-4f86-9350a49c6d04/4/largeicon.png","name":"IRON 2","tier":4,"color":"4f514fff","division":"IRON"},{"icon":"https://media.valorant-api.com/competitivetiers/03621f52-342b-cf4e-4f86-9350a49c6d04/5/largeicon.png","name":"IRON 3","tier":5,"color":"4f514fff","division":"IRON"},{"icon":"https://media.valorant-api.com/competitivetiers/03621f52-342b-cf4e-4f86-9350a49c6d04/6/largeicon.png","name":"BRONZE 1","tier":6,"color":"a5855dff","division":"BRONZE"},{"icon":"https://media.valorant-api.com/competitivetiers/03621f52-342b-cf4e-4f86-9350a49c6d04/7/largeicon.png","name":"BRONZE 2","tier":7,"color":"a5855dff","division":"BRONZE"},{"icon":"https://media.valorant-api.com/competitivetiers/03621f52-342b-cf4e-4f86-9350a49c6d04/8/largeicon.png","name":"BRONZE 3","tier":8,"color":"a5855dff","division":"BRONZE"},{"icon":"https://media.valorant-api.com/competitivetiers/03621f52-342b-cf4e-4f86-9350a49c6d04/9/largeicon.png","name":"SILVER 1","tier":9,"color":"bbc2c2ff","division":"SILVER"},{"icon":"https://media.valorant-api.com/competitivetiers/03621f52-342b-cf4e-4f86-9350a49c6d04/10/largeicon.png","name":"SILVER 2","tier":10,"color":"bbc2c2ff","division":"SILVER"},{"icon":"https://media.valorant-api.com/competitivetiers/03621f52-342b-cf4e-4f86-9350a49c6d04/11/largeicon.png","name":"SILVER 3","tier":11,"color":"bbc2c2ff","division":"SILVER"},{"icon":"https://media.valorant-api.com/competitivetiers/03621f52-342b-cf4e-4f86-9350a49c6d04/12/largeicon.png","name":"GOLD 1","tier":12,"color":"eccf56ff","division":"GOLD"},{"icon":"https://media.valorant-api.com/competitivetiers/03621f52-342b-cf4e-4f86-9350a49c6d04/13/largeicon.png","name":"GOLD 2","tier":13,"color":"eccf56ff","division":"GOLD"},{"icon":"https://media.valorant-api.com/competitivetiers/03621f52-342b-cf4e-4f86-9350a49c6d04/14/largeicon.png","name":"GOLD 3","tier":14,"color":"eccf56ff","division":"GOLD"},{"icon":"https://media.valorant-api.com/competitivetiers/03621f52-342b-cf4e-4f86-9350a49c6d04/15/largeicon.png","name":"PLATINUM 1","tier":15,"color":"59a9b6ff","division":"PLATINUM"},{"icon":"https://media.valorant-api.com/competitivetiers/03621f52-342b-cf4e-4f86-9350a49c6d04/16/largeicon.png","name":"PLATINUM 2","tier":16,"color":"59a9b6ff","division":"PLATINUM"},{"icon":"https://media.valorant-api.com/competitivetiers/03621f52-342b-cf4e-4f86-9350a49c6d04/17/largeicon.png","name":"PLATINUM 3","tier":17,"color":"59a9b6ff","division":"PLATINUM"},{"icon":"https://media.valorant-api.com/competitivetiers/03621f52-342b-cf4e-4f86-9350a49c6d04/18/largeicon.png","name":"DIAMOND 1","tier":18,"color":"b489c4ff","division":"DIAMOND"},{"icon":"https://media.valorant-api.com/competitivetiers/03621f52-342b-cf4e-4f86-9350a49c6d04/19/largeicon.png","name":"DIAMOND 2","tier":19,"color":"b489c4ff","division":"DIAMOND"},{"icon":"https://media.valorant-api.com/competitivetiers/03621f52-342b-cf4e-4f86-9350a49c6d04/20/largeicon.png","name":"DIAMOND 3","tier":20,"color":"b489c4ff","division":"DIAMOND"},{"icon":"https://media.valorant-api.com/competitivetiers/03621f52-342b-cf4e-4f86-9350a49c6d04/21/largeicon.png","name":"ASCENDANT 1","tier":21,"color":"6ae2afff","division":"ASCENDANT"},{"icon":"https://media.valorant-api.com/competitivetiers/03621f52-342b-cf4e-4f86-9350a49c6d04/22/largeicon.png","name":"ASCENDANT 2","tier":22,"color":"6ae2afff","division":"ASCENDANT"},{"icon":"https://media.valorant-api.com/competitivetiers/03621f52-342b-cf4e-4f86-9350a49c6d04/23/largeicon.png","name":"ASCENDANT 3","tier":23,"color":"6ae2afff","division":"ASCENDANT"},{"icon":"https://media.valorant-api.com/competitivetiers/03621f52-342b-cf4e-4f86-9350a49c6d04/24/largeicon.png","name":"IMMORTAL 1","tier":24,"color":"bb3d65ff","division":"IMMORTAL"},{"icon":"https://media.valorant-api.com/competitivetiers/03621f52-342b-cf4e-4f86-9350a49c6d04/25/largeicon.png","name":"IMMORTAL 2","tier":25,"color":"bb3d65ff","division":"IMMORTAL"},{"icon":"https://media.valorant-api.com/competitivetiers/03621f52-342b-cf4e-4f86-9350a49c6d04/26/largeicon.png","name":"IMMORTAL 3","tier":26,"color":"bb3d65ff","division":"IMMORTAL"},{"icon":"https://media.valorant-api.com/competitivetiers/03621f52-342b-cf4e-4f86-9350a49c6d04/27/largeicon.png","name":"RADIANT","tier":27,"color":"ffffaaff","division":"RADIANT"}],"set_uuid":"03621f52-342b-cf4e-4f86-9350a49c6d04"},"meta":{"timestamp":"2026-06-01T00:04:03.711Z","request_id":"f6617f79-2555-46cc-8a40-aeec4dc4f4e3"},"status":"ok","message":"Tiers retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"VALORANT game content. /v1/agents (all playable agents; ?name=Jett for one with abilities & lore; ?role=Duelist|Initiator|Controller|Sentinel to filter); /v1/maps (?name=Bind for one — callouts, coordinates, splash); /v1/weapons (?name=Vandal for one with its skins; ?category=Rifle to filter — cost, fire rate, magazine, head/body/leg damage); /v1/tiers (current competitive ranks Iron→Radiant with colors); /v1/gamemodes (playable modes). Game data from valorant-api.com. Not affiliated with Riot Games.","source":"valorant-api.com (community VALORANT game-data API)","endpoints":["/v1/agents","/v1/maps","/v1/weapons","/v1/tiers","/v1/gamemodes","/v1/meta"]},"meta":{"timestamp":"2026-06-01T00:04:03.763Z","request_id":"f0e43380-1e8b-47b1-8555-defc55e6f22a"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":3450,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":490,"monthly_call_quota":44500,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1460,"monthly_call_quota":212000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":4040,"monthly_call_quota":1075000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/valorant-api"}