Live, Schedule & Search Endpoints

14 endpoints for live bandy matches, schedules, search, and discovery

Live & Schedule (7 endpoints)

Live Matches

GET /api/live

Curated live matches with teams, scores, and half info.

Live (All)

GET /api/live/all

Raw live data for all bandy matches.

Today’s Matches

GET /api/today

Schedule by Date

GET /api/schedule/:date

Date format: YYYY-MM-DD. Example: GET /api/schedule/2026-03-13

Live Tournaments

GET /api/live-tournaments

Tournaments with live matches right now.

Scheduled Tournaments

GET /api/scheduled-tournaments/:date

Tournaments with matches on a specific date.

Newly Added Events

GET /api/newly-added-events

Response Example — /api/live

{
  "events": [
    {
      "id": 12345678,
      "homeTeam": { "id": 1501, "name": "Sandvikens AIK" },
      "awayTeam": { "id": 1502, "name": "Bollnäs GIF" },
      "homeScore": {
        "current": 5,
        "display": 5,
        "period1": 3,
        "period2": 2
      },
      "awayScore": {
        "current": 3,
        "display": 3,
        "period1": 1,
        "period2": 2
      },
      "status": { "code": 7, "description": "2nd Half", "type": "inprogress" },
      "tournament": { "name": "Elitserien", "id": 350 },
      "startTimestamp": 1737331200
    }
  ]
}

Score Fields

Field	Description
period1	1st half goals (45 min)
period2	2nd half goals (45 min)
overtime	Extra time goals (if applicable)
current	Total goals

Bandy is played on ice with 11 players per side, similar to football. Season runs October–March (Sweden, Finland, Russia).

---

Search & Discovery (7 endpoints)

Search

GET /api/search?q=sandviken

Search teams, players, and tournaments.

Countries / Categories

GET /api/countries

Bandy categories (International, Sweden, Finland, etc.).

Countries (Extended)

GET /api/countries/all

Category Tournaments

GET /api/categories/:categoryId/tournaments

Tournaments in a country/category.

Trending Players

GET /api/trending-players

Bandy News

GET /api/news?lang=en

Country Flag

GET /api/country/:code/flag