API Reference

Leagues

List and view leagues, seasons, and standings data.

Required Scope:leagues:read

List Leagues

GET/api/v1/leagues

Returns a paginated list of leagues. Only public leagues and leagues owned by the authenticated user are returned.

Query Parameters

Parameter	Type	Required	Description
`page`	`integer`	Optional	Page number (default: 1)
`per_page`	`integer`	Optional	Results per page, max 100 (default: 25)
`sort`	`string`	Optional	Sort field: created_at, name, status
`direction`	`string`	Optional	Sort direction: asc or desc (default: desc)
`filter[status]`	`string`	Optional	Filter by status: draft, active, completed, archived
`filter[game]`	`string`	Optional	Filter by game name (partial match)
`filter[platform]`	`string`	Optional	Filter by platform
`filter[visibility]`	`string`	Optional	Filter by visibility: public, private

Example Requestbash

curl "https://readyraider.com/api/v1/leagues?filter[status]=active&sort=name&direction=asc" \
  -H "Authorization: Bearer rr_live_your_key"

Response (200 OK)json

{
  "data": [
    {
      "id": "league-uuid",
      "name": "Valorant Ranked League",
      "slug": "valorant-ranked-league",
      "description": "Weekly competitive league...",
      "game": "Valorant",
      "platform": "PC",
      "status": "active",
      "visibility": "public",
      "owner_id": "user-uuid",
      "organization_id": "org-uuid",
      "created_at": "2026-01-15T10:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 25,
    "total": 3,
    "total_pages": 1
  }
}

Get League

GET/api/v1/leagues/:id

Returns a single league by ID or slug. Private leagues return 404 unless you are the owner.

Path Parameters

Parameter	Type	Required	Description
`id`	`uuid \| string`	Required	League UUID or slug

Example Requestbash

curl "https://readyraider.com/api/v1/leagues/valorant-ranked-league" \
  -H "Authorization: Bearer rr_live_your_key"

Response (200 OK)json

{
  "data": {
    "id": "league-uuid",
    "name": "Valorant Ranked League",
    "slug": "valorant-ranked-league",
    "description": "Weekly competitive league with ELO-based matchmaking.",
    "game": "Valorant",
    "platform": "PC",
    "status": "active",
    "visibility": "public",
    "max_teams": 64,
    "team_size": 5,
    "rules": "Standard competitive rules apply...",
    "owner_id": "user-uuid",
    "organization_id": "org-uuid",
    "created_at": "2026-01-15T10:00:00Z",
    "updated_at": "2026-02-10T14:30:00Z"
  }
}

Get Standings

GET/api/v1/leagues/:id/standings

Returns paginated standings for a league's active season, or a specific season if season_id is provided. Standings are sorted by ELO rating by default.

Path Parameters

Parameter	Type	Required	Description
`id`	`uuid \| string`	Required	League UUID or slug

Query Parameters

Parameter	Type	Required	Description
`season_id`	`uuid`	Optional	Specific season ID (defaults to active season)
`page`	`integer`	Optional	Page number (default: 1)
`per_page`	`integer`	Optional	Results per page, max 100 (default: 25)
`sort`	`string`	Optional	Sort field: elo, wins, losses, rank, streak (default: elo)
`direction`	`string`	Optional	Sort direction: asc or desc (default: desc)

Example Requestbash

curl "https://readyraider.com/api/v1/leagues/valorant-ranked-league/standings?per_page=10" \
  -H "Authorization: Bearer rr_live_your_key"

Response (200 OK)json

{
  "data": [
    {
      "id": "standing-uuid",
      "season_id": "season-uuid",
      "league_team_id": "team-uuid",
      "elo": 1850,
      "wins": 12,
      "losses": 3,
      "match_wins": 24,
      "match_losses": 8,
      "streak": 5,
      "rank": 1,
      "last_match_at": "2026-02-12T21:00:00Z"
    },
    {
      "id": "standing-uuid-2",
      "season_id": "season-uuid",
      "league_team_id": "team-uuid-2",
      "elo": 1720,
      "wins": 10,
      "losses": 5,
      "match_wins": 21,
      "match_losses": 12,
      "streak": -2,
      "rank": 2,
      "last_match_at": "2026-02-11T20:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 10,
    "total": 24,
    "total_pages": 3
  }
}

Note

A positive streak value indicates consecutive wins, while a negative value indicates consecutive losses.

PreviousTournaments API

NextOrganizations API