{"openapi":"3.1.0","info":{"title":"ValoExpo VALORANT Platform API","version":"1.0.0","description":"Complete, production-ready, non-commercial VALORANT web API providing account intelligence, inventory inspection, live match tracking, store offers, and content catalog access.","contact":{"name":"ValoExpo Engineering","url":"https://github.com/valoexpo/valoexpo"},"license":{"name":"MIT"}},"servers":[{"url":"/api/v1","description":"Primary v1 API Endpoint"}],"paths":{"/health":{"get":{"summary":"System Health & Provider Status","description":"Returns server uptime, database connectivity, and upstream provider readiness.","responses":{"200":{"description":"System healthy"}}}},"/accounts/search":{"get":{"summary":"Search Account","description":"Search for a VALORANT player account by Riot ID (name and tag) and regional routing.","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string"}},{"name":"tag","in":"query","required":true,"schema":{"type":"string"}},{"name":"region","in":"query","required":false,"schema":{"type":"string","default":"na"}}],"responses":{"200":{"description":"Account found"},"404":{"description":"Account not found"}}}},"/accounts/{accountId}":{"get":{"summary":"Get Account Profile","description":"Retrieve base account identity, level, card artwork, and verified status.","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Account profile"},"404":{"description":"Account not found"}}}},"/accounts/{accountId}/overview":{"get":{"summary":"Account Overview","description":"Aggregated dashboard view including profile, rank, penalties, and summary statistics.","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Overview payload"}}}},"/accounts/{accountId}/rank":{"get":{"summary":"Competitive Rank Details","description":"Current tier, rank rating (RR), peak rank, and leaderboard status.","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Current rank payload"}}}},"/accounts/{accountId}/rank/history":{"get":{"summary":"Competitive Rank Progression","description":"Historical act-by-act ranks and win milestones.","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Rank history array"}}}},"/accounts/{accountId}/matches":{"get":{"summary":"Match History","description":"Recent match records, combat score, KD ratio, headshot percentage, and round outcomes.","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Matches list and aggregate metrics"}}}},"/accounts/{accountId}/collection":{"get":{"summary":"Collection Summary & Valuation","description":"Total weapon skins, cosmetics count, and collection valuation breakdown in VP and USD.","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Collection valuation report"}}}},"/accounts/{accountId}/skins":{"get":{"summary":"Owned Weapon Skins","description":"List of owned weapon skins with chromas, levels, and weapon categorization.","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string"}},{"name":"weapon","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Skins list"}}}},"/accounts/{accountId}/store":{"get":{"summary":"Daily Store Offers","description":"Personal 4 daily skin offers with countdown timer to 00:00 UTC and VP cost. Returns explicit unlinked state if not authorized.","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Store offers payload"}}}},"/accounts/{accountId}/night-market":{"get":{"summary":"Night Market Offers","description":"6 discounted skin offers with discount percentages and original vs discounted prices.","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Night market payload"}}}},"/accounts/{accountId}/missions":{"get":{"summary":"Daily & Weekly Missions","description":"Active mission objectives, completion progress, and XP / Kingdom Credit rewards.","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Missions list"}}}},"/accounts/{accountId}/penalties":{"get":{"summary":"Account Warnings & Penalties","description":"Active AFK warnings, queue restrictions, and remaining games required to reset penalty.","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Penalties list"}}}},"/content/agents":{"get":{"summary":"All Playable Agents","description":"Direct catalog access to all VALORANT agents with abilities, portraits, and roles.","responses":{"200":{"description":"Agents catalog"}}}},"/content/weapons":{"get":{"summary":"Weapon Catalog","description":"All weapon archetypes, weapon stats, and default configurations.","responses":{"200":{"description":"Weapons catalog"}}}},"/content/skins":{"get":{"summary":"Weapon Skin Catalog","description":"Searchable catalog of all VALORANT weapon skins with chromas, levels, and videos.","parameters":[{"name":"search","in":"query","required":false,"schema":{"type":"string"}},{"name":"tier","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Skins catalog"}}}}}}