RYVL API Documentation

Appearance

Tournaments ​

Endpoints for accessing tournament information.

List Tournaments ​

Get a paginated list of tournaments.

Endpoint ​

GET /api/auth/tournaments

Query Parameters ​

  • sport_id (optional) - Filter by sport
  • country (optional) - Filter by country
  • active (optional) - Filter active tournaments only
  • page (optional) - Page number
  • per_page (optional) - Items per page (default: 20)

Response ​

json
{
  "data": [
    {
      "id": 1,
      "name": "Premier League",
      "slug": "premier-league",
      "sport_id": 1,
      "country": "England",
      "logo": "https://cdn.example.com/tournaments/premier-league.png",
      "start_date": "2024-08-01",
      "end_date": "2025-05-31",
      "active": true
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 5,
    "per_page": 20,
    "total": 100
  }
}

Get All Tournaments ​

Get all tournaments without pagination.

Endpoint ​

GET /api/auth/tournaments/all

Response ​

json
{
  "data": [
    {
      "id": 1,
      "name": "Premier League",
      "slug": "premier-league",
      "sport_id": 1,
      "country": "England"
    },
    {
      "id": 2,
      "name": "La Liga",
      "slug": "la-liga",
      "sport_id": 1,
      "country": "Spain"
    }
  ]
}

Get Tournament Details ​

Get detailed information about a specific tournament.

Endpoint ​

GET /api/auth/tournaments/{id}

Response ​

json
{
  "data": {
    "id": 1,
    "name": "Premier League",
    "slug": "premier-league",
    "sport_id": 1,
    "sport": {
      "id": 1,
      "name": "Football",
      "slug": "football"
    },
    "country": "England",
    "logo": "https://cdn.example.com/tournaments/premier-league.png",
    "start_date": "2024-08-01",
    "end_date": "2025-05-31",
    "active": true,
    "current_season": {
      "id": 10,
      "name": "2024/25",
      "start_date": "2024-08-01",
      "end_date": "2025-05-31"
    },
    "teams_count": 20,
    "matches_count": 380
  }
}

Error Responses ​

  • 404 - Tournament not found