Match history

Paginated match history with queue and time filter.

Path params

shard*LeagueShard

League shardpuuid*stringRiot puuid

Query params

queueGameQueueTypedefault: ALL

Queue filter, ALL means no filterlimitintegerdefault: 20Limit 1..100offsetintegerdefault: 0Offset >=0timeStartintegerdefault: 0Start timestamp in epoch milliseconds, 0 = no lower boundtimeEndintegerdefault: 0End timestamp in epoch milliseconds, 0 = no upper boundsortstringdefault: timeStart:desc

Sort order

Request

https://api.safjnest.com/api/lol/EUW1/profile/{puuid}/matches?queue=ALL&limit=20&offset=0&timeStart=0&timeEnd=0&sort=timeStart%3Adesc

curl "https://api.safjnest.com/api/lol/EUW1/profile/{puuid}/matches?queue=ALL&limit=20&offset=0&timeStart=0&timeEnd=0&sort=timeStart%3Adesc"

Missing required: puuid

CORS enabled (*) — runs directly in your browser against https://api.safjnest.com

GET /api/lol/{shard}/profile/{puuid}/matches

Paginated history with queue and time filter.

Controller: LolController.java:91 → MatchService.getPage(puuid, shard, timeStart, timeEnd, queue, offset, limit, order) (:113)
Response: 200 MatchPage with ResponseMetadata.pagination (:123)

Parameter	Position	Default	Validation	Notes
`shard`	path	—	`requiredShard` `:163`	`LeagueShard`
`puuid`	path	—	`requiredText` `:230`
`queue`	query	`null` (`ALL`)	`optionalQueue` `:56`	`GameQueueType` or `ALL`→null, canonical via `GameQueueTypeUtils.canonicalQueue`
`limit`	query	`20`	`matchLimit` `:210` `1..100`
`offset`	query	`0`	`matchOffset` `:217` `>=0`
`timeStart`	query	`0`	`>=0`, validated in `activityFilter` `:147`	epoch millis, `0`=no filter
`timeEnd`	query	`0`	`>=0`, `>=timeStart` if both non-zero
`sort`	query	`timeStart:desc`	`matchOrder` `:222`	`timeStart:asc` or `timeStart:desc`

Response: MatchPage (src/main/java/com/safjnest/lol/model/match/MatchPage.java):

java

public record MatchPage(List<MatchResult> matches, int limit, int offset, long total, boolean hasMore, ResponseMetadata metadata) {}

MatchResult is the lightweight match projection for lists (see reference/dtos.mdx).

curl

bash

curl "https://api.safjnest.com/api/lol/EUW1/profile/abc-puuid/matches?limit=20&offset=0&sort=timeStart:desc&queue=RANKED_SOLO_5X5"