OpenAPI 3.1 Specification

ValoExpo REST API v1

Fully documented, versioned internal REST API for VALORANT accounts, collections, store intelligence, and content catalogs. All responses are formatted in strict JSON envelopes with runtime validation.

Raw openapi.jsonLive Health Check

Base Endpoint

/api/v1

All routes are namespaced under version 1.

Response Envelope

Every route returns standard success, data, and meta with data source attribution and cache tags.

Rate Limits & CORS

Public content endpoints are aggressively cached via HTTP headers. Account search endpoints are rate limited.

API Directory (16 Endpoints)

GET/api/v1/health
System Health & Provider Status

Returns server uptime, database connectivity, and upstream provider readiness.

Test Endpoint Live
GET/api/v1/accounts/search
Search Account

Search for a VALORANT player account by Riot ID (name and tag) and regional routing.

Parameters
name (query)*tag (query)*region (query)
Test Endpoint Live
GET/api/v1/accounts/{accountId}
Get Account Profile

Retrieve base account identity, level, card artwork, and verified status.

Parameters
accountId (path)*
Test Endpoint Live
GET/api/v1/accounts/{accountId}/overview
Account Overview

Aggregated dashboard view including profile, rank, penalties, and summary statistics.

Parameters
accountId (path)*
Test Endpoint Live
GET/api/v1/accounts/{accountId}/rank
Competitive Rank Details

Current tier, rank rating (RR), peak rank, and leaderboard status.

Parameters
accountId (path)*
Test Endpoint Live
GET/api/v1/accounts/{accountId}/rank/history
Competitive Rank Progression

Historical act-by-act ranks and win milestones.

Parameters
accountId (path)*
Test Endpoint Live
GET/api/v1/accounts/{accountId}/matches
Match History

Recent match records, combat score, KD ratio, headshot percentage, and round outcomes.

Parameters
accountId (path)*
Test Endpoint Live
GET/api/v1/accounts/{accountId}/collection
Collection Summary & Valuation

Total weapon skins, cosmetics count, and collection valuation breakdown in VP and USD.

Parameters
accountId (path)*
Test Endpoint Live
GET/api/v1/accounts/{accountId}/skins
Owned Weapon Skins

List of owned weapon skins with chromas, levels, and weapon categorization.

Parameters
accountId (path)*weapon (query)
Test Endpoint Live
GET/api/v1/accounts/{accountId}/store
Daily Store Offers

Personal 4 daily skin offers with countdown timer to 00:00 UTC and VP cost. Returns explicit unlinked state if not authorized.

Parameters
accountId (path)*
Test Endpoint Live
GET/api/v1/accounts/{accountId}/night-market
Night Market Offers

6 discounted skin offers with discount percentages and original vs discounted prices.

Parameters
accountId (path)*
Test Endpoint Live
GET/api/v1/accounts/{accountId}/missions
Daily & Weekly Missions

Active mission objectives, completion progress, and XP / Kingdom Credit rewards.

Parameters
accountId (path)*
Test Endpoint Live
GET/api/v1/accounts/{accountId}/penalties
Account Warnings & Penalties

Active AFK warnings, queue restrictions, and remaining games required to reset penalty.

Parameters
accountId (path)*
Test Endpoint Live
GET/api/v1/content/agents
All Playable Agents

Direct catalog access to all VALORANT agents with abilities, portraits, and roles.

Test Endpoint Live
GET/api/v1/content/weapons
Weapon Catalog

All weapon archetypes, weapon stats, and default configurations.

Test Endpoint Live
GET/api/v1/content/skins
Weapon Skin Catalog

Searchable catalog of all VALORANT weapon skins with chromas, levels, and videos.

Parameters
search (query)tier (query)
Test Endpoint Live