RYVL API Documentation

Appearance

Unique Tournaments ​

Endpoints for accessing unique tournament information (competitions that span multiple seasons).

List Unique Tournaments ​

Get a paginated list of unique tournaments.

Endpoint ​

GET /api/auth/unique-tournaments

Query Parameters ​

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

Response ​

json
{
  "data": [
    {
      "id": 1,
      "name": "English Premier League",
      "slug": "english-premier-league",
      "sport_id": 1,
      "category": "England",
      "logo": "https://cdn.example.com/unique-tournaments/epl.png"
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 3,
    "per_page": 20,
    "total": 60
  }
}

Get All Unique Tournaments ​

Get all unique tournaments without pagination.

Endpoint ​

GET /api/auth/unique-tournaments/all

Response ​

json
{
  "data": [
    {
      "id": 1,
      "name": "English Premier League",
      "slug": "english-premier-league",
      "sport_id": 1,
      "category": "England"
    },
    {
      "id": 2,
      "name": "UEFA Champions League",
      "slug": "uefa-champions-league",
      "sport_id": 1,
      "category": "Europe"
    }
  ]
}

Get Unique Tournament Details ​

Get detailed information about a specific unique tournament.

Endpoint ​

GET /api/auth/unique-tournaments/{id}

Response ​

json
{
  "data": {
    "id": 1,
    "name": "English Premier League",
    "slug": "english-premier-league",
    "sport_id": 1,
    "sport": {
      "id": 1,
      "name": "Football",
      "slug": "football"
    },
    "category": "England",
    "logo": "https://cdn.example.com/unique-tournaments/epl.png",
    "seasons": [
      {
        "id": 10,
        "name": "2024/25",
        "year": "2024/25",
        "start_date": "2024-08-01",
        "end_date": "2025-05-31",
        "current": true
      },
      {
        "id": 9,
        "name": "2023/24",
        "year": "2023/24",
        "start_date": "2023-08-01",
        "end_date": "2024-05-31",
        "current": false
      }
    ]
  }
}

Error Responses ​

  • 404 - Unique tournament not found