LeagueRepublic JSON API

1Introduction

The LeagueRepublic JSON API lets a website, app or program read a league's seasons, fixture groups, fixtures, results, standings, teams and statistics. It is read-only: nothing can be changed through it. Data is returned as JSON.

Each service in section 4 documents its URL, request parameters, response fields, an example and any errors specific to it.

Audience: LR developers maintaining the interface, and league or third-party developers integrating with these services, including people using an AI assistant to build with them.

1.1Identifiers

All IDs are LeagueRepublic integer IDs. They never change and are never reused.

2Access and environments

• No API key is needed. Access is controlled per league: the league must be on the Gold plan and have Enable JSON API ticked on Admin Home > API > API Settings. Unticking it switches the API off for that league immediately.
• All services are Read. Every request is an HTTP GET; there are no write services.
• Use HTTPS on Live. Browsers may call the API directly from pages on other websites (cross-origin requests are allowed).
• Full URL = base URL + path.

2.1Rate limit

Up to 60 requests a minute per league, counted across every caller using that league's data: its website, apps and any other integration share the same allowance. A few leagues have a lower limit; the limit that applies is returned in max_calls_per_minute. Over the limit, the API returns HTTP 429 with the body below; wait the number of seconds in retry_after_seconds before trying again. Cache responses and avoid polling more than once a minute.

{
  "status": "error",
  "code": 429,
  "message": "Rate limit exceeded",
  "details": {
    "max_calls_per_minute": 60,
    "retry_after_seconds": 60,
    "error_code": "RATE_LIMIT_EXCEEDED"
  }
}

3Conventions

3.1URL and request patterns

• Every service is a path-parameter service: parameters are embedded in the URL, shown in square brackets, e.g. /getFixturesForTeam/[seasonID]/[teamID].json.
• Every path ends in .json. There are no query strings and no request bodies.

3.2Data types and formats

Road means away. road… fields are the away team; home… fields are the home team.

Scores are text. homeScore and roadScore are varchar so they can hold letters such as "P" (postponed). Convert to a number before doing arithmetic.

Dates come twice. fixtureDate is the league's local date and time as yyyyMMdd HH:mm, e.g. "20261002 19:30". fixtureDateInMilliseconds is the same moment as milliseconds since 1 January 1970 UTC. Use the milliseconds for sorting and time zones.

Date parameters. Dates passed in a URL are yyyyMMdd, e.g. 20261003.

Empty values. A field that does not apply, or was not entered, is null. Most fields are always present even when null.

Approved results only. Every service except Get Match Hub returns a result only once the league has approved it. Get Match Hub also returns unapproved and live results, marked by approved.

Hidden data. Anything the league hides on its own website (hidden divisions, scores or standings) is not returned.

3.3Parameter tables

Each service documents its request and response as a table with these columns: Level (nesting depth, 1 = top level), Field (JSON attribute name; <List> marks an array), Type, Required (request: Y = must be supplied; response: Y = always present), Nullable (Y = value may be null) and Notes.

3.4Return codes and errors

Errors other than the rate limit are returned with HTTP status 200 and a JSON object holding a single error field. Check for the error field rather than the HTTP status or the exact wording.

{"error" : "Season does not exist for supplied season ID"}

The wording of messages from the v1.3 services varies slightly between services. Only the presence of error is guaranteed.

4Service reference

Service summary

4.1Get Seasons For League

Returns the league's seasons.

Service type: Read — base URLs in §2.

/getSeasonsForLeague/[leagueID].json

Request parameters

Response fields

A <List> of seasons.

Request / response example

GET https://api.leaguerepublic.com/json/getSeasonsForLeague/770829510.json

[
  {
    "currentSeason": true,
    "seasonEndDate": "20230617 23:59",
    "seasonEndDateInMilliseconds": 1687046340000,
    "seasonID": 153020000,
    "seasonName": "2022 / 2023",
    "seasonStartDate": "20220617 00:00",
    "seasonStartDateInMilliseconds": 1655424000000
  }
]

Errors

Standard shapes in §3.4.

4.2Get Fixture Groups For Season

Returns the season's divisions, competitions and other fixture groups.

Service type: Read — base URLs in §2.

/getFixtureGroupsForSeason/[seasonID].json

Request parameters

Response fields

A <List> of fixture groups.

Request / response example

GET https://api.leaguerepublic.com/json/getFixtureGroupsForSeason/236635540.json

[
  {
    "fixtureGroupDesc": "Premier Division",
    "fixtureGroupIdentifier": 389974692,
    "fixtureTypeDesc": "Division",
    "fixtureTypeID": 1
  }
]

Errors

Standard shapes in §3.4.

4.3Get Standings For Fixture Group

Returns the league table for a division, or one table per group for a group-stage competition.

Service type: Read — base URLs in §2.

/getStandingsForFixtureGroup/[fixtureTypeID]/[fixtureGroupIdentifier].json

Request parameters

Response fields

A <List> of tables. A division returns one; a group-stage competition returns one per group.

Request / response example

GET https://api.leaguerepublic.com/json/getStandingsForFixtureGroup/1/389974692.json

[
  {
    "standingsDesc": "Premier Division",
    "standingsLines": [
      {
        "position": "1",
        "teamID": 191899149,
        "teamName": "Arthurlie",
        "overallPlayed": 6,
        "overallWon": 5,
        "overallTied": 0,
        "overallLoss": 1,
        "overallScoreFor": 15,
        "overallScoreAgainst": 8,
        "scoreDifference": 7,
        "points": 15,
        "recentForm": "WLWWWW"
      }
    ]
  }
]

Trimmed to the main fields of one line. Every field in the table above is returned.

Errors

Standard shapes in §3.4.

4.4Get Fixtures For Season

Returns every fixture in the season, played and unplayed, across all fixture groups.

Service type: Read — base URLs in §2.

/getFixturesForSeason/[seasonID].json

Request parameters

Response fields

A <List> of fixtures.

Request / response example

GET https://api.leaguerepublic.com/json/getFixturesForSeason/922046009.json

[
  {
    "fixtureID": 41048450,
    "fixtureDate": "20250719 14:00",
    "fixtureDateInMilliseconds": 1752930000000,
    "fixtureDateStatusID": 1,
    "fixtureDateStatusDesc": "Normal / Scheduled",
    "fixtureGroupDesc": "West Of Scotland Charity Cup",
    "fixtureGroupIdentifier": 638722492,
    "fixtureTypeID": 2,
    "fixtureStatus": 0,
    "fixtureStatusDesc": "Normal",
    "homeTeam": 504402802,
    "homeTeamName": "Clydebank",
    "roadTeam": 363729896,
    "roadTeamName": "Auchinleck Talbot",
    "homeScore": "4",
    "roadScore": "1",
    "homeScoreNote": null,
    "roadScoreNote": null,
    "additionalScore": "(HT 2-0)",
    "result": true,
    "noResultOutcome": false,
    "fixtureNote": null,
    "roundDesc": "Final",
    "shortCode": "C",
    "venueAndSubVenueDesc": "Holm Park"
  }
]

Trimmed to one fixture.

Errors

Standard shapes in §3.4. Known issue: additionalScore is currently always null on this service and on Get Fixtures For Fixture Group. Get Fixtures For Team and Get Match Hub return it.

4.5Get Fixtures For Fixture Group

Returns every fixture in one division, competition or other fixture group.

Service type: Read — base URLs in §2.

/getFixturesForFixtureGroup/[fixtureTypeID]/[fixtureGroupIdentifier].json

Request parameters

Response fields

A <List> of fixtures. The fixture group fields are not repeated on each fixture.

Request / response example

GET https://api.leaguerepublic.com/json/getFixturesForFixtureGroup/1/389974692.json

Same shape as Get Fixtures For Season, without the fixture group fields.

Errors

Standard shapes in §3.4. Known issue: additionalScore is currently always null on this service.

4.6Get Fixtures For Fixture Group Including Official Assignments

As Get Fixtures For Fixture Group, plus the fixture group fields and the officials (referees, umpires) assigned to each fixture.

Service type: Read — base URLs in §2.

/getFixturesForFixtureGroupIncludingOfficialAssignments/[fixtureTypeID]/[fixtureGroupIdentifier].json

Request parameters

Response fields

A <List> of fixtures.

Request / response example

GET https://api.leaguerepublic.com/json/getFixturesForFixtureGroupIncludingOfficialAssignments/1/389974692.json

"officialAssignments": [
  {
    "firstName": "Paulo",
    "lastName": "Silva",
    "officialPositionID": 1
  }
]

Only the officials field is shown. Every other field is as in Get Fixtures For Season.

Errors

Standard shapes in §3.4.

4.7Get Fixtures For Team

New in 1.4

Returns every fixture one team has in a season, across all fixture groups, earliest first.

Service type: Read — base URLs in §2.

/getFixturesForTeam/[seasonID]/[teamID].json

Request parameters

Response fields

A <List> of fixtures, sorted by date ascending. Same fields as Get Fixtures For Season, without officialAssignments. An empty list means the team has no fixtures in that season.

To tell whether the team was home or away, compare its ID with homeTeam and roadTeam.

Request / response example

GET https://api.leaguerepublic.com/json/getFixturesForTeam/922046009/504402802.json

[
  {
    "fixtureID": 41048450,
    "fixtureDate": "20250719 14:00",
    "fixtureDateInMilliseconds": 1752930000000,
    "fixtureDateStatusID": 1,
    "fixtureDateStatusDesc": "Normal / Scheduled",
    "fixtureGroupDesc": "West Of Scotland Charity Cup",
    "fixtureGroupIdentifier": 638722492,
    "fixtureTypeID": 2,
    "fixtureStatus": 0,
    "fixtureStatusDesc": "Normal",
    "homeTeam": 504402802,
    "homeTeamName": "Clydebank",
    "roadTeam": 363729896,
    "roadTeamName": "Auchinleck Talbot",
    "homeScore": "4",
    "roadScore": "1",
    "homeScoreNote": null,
    "roadScoreNote": null,
    "additionalScore": "(HT 2-0)",
    "result": true,
    "noResultOutcome": false,
    "fixtureNote": null,
    "roundDesc": "Final",
    "shortCode": "C",
    "venueAndSubVenueDesc": "Holm Park"
  }
]

Trimmed to one fixture.

Errors

Standard shapes in §3.4.

4.8Get Match Hub

New in 1.4

Returns everything on the league's Match Hub page for one day: seasons, match days, the day's fixtures grouped by fixture group, and the table for each division playing.

Service type: Read — base URLs in §2.

/getMatchHub/[seasonID].json
/getMatchHub/[seasonID]/[date].json

Request parameters

Response fields

An object. If the requested date has no fixtures, the default day is returned; matchHubDate shows which day was returned.

Innings scores and the final score are entered separately by the league and may not add up, for example on awarded results.

Request / response example

GET https://api.leaguerepublic.com/json/getMatchHub/236635540/20261002.json

{
  "seasonID": 236635540,
  "seasonList": [
    { "seasonID": 922046009, "seasonName": "2025-2026" },
    { "seasonID": 236635540, "seasonName": "2026-2027" }
  ],
  "matchHubDate": "20261002",
  "matchHubRecapContentText": null,
  "matchHubRecapLoadDateTime": null,
  "dateList": [
    { "matchHubDate": "20261002", "matchCount": 1, "resultCount": 0, "liveResultCount": 0 },
    { "matchHubDate": "tbc", "matchCount": 5, "resultCount": null, "liveResultCount": null }
  ],
  "fixtureGroupList": [
    {
      "fixtureGroupDesc": "Scottish Gas Scottish Cup - Round 1",
      "fixtureGroupIdentifier": 406990226,
      "fixtureTypeID": 2,
      "fixtures": [
        {
          "fixtureID": 45132961,
          "fixtureDate": "20261002 19:30",
          "fixtureDateInMilliseconds": 1790965800000,
          "homeTeam": 551804519,
          "homeTeamName": "Cumnock Juniors",
          "roadTeam": 363729896,
          "roadTeamName": "Auchinleck Talbot",
          "homeScore": null,
          "roadScore": null,
          "result": false,
          "approved": false,
          "roundDesc": "Round 1",
          "venueAndSubVenueDesc": "Townhead Park",
          "gameGroups": null,
          "innings": null
        }
      ],
      "standings": null
    }
  ]
}

Trimmed to one fixture and the main fields. Every field in the table above is returned.

gameGroups (darts)

"gameGroups": [
  {
    "gameGroupDesc": "Pairs",
    "gameGroupDescShort": "PRS",
    "homeWinCount": 2,
    "roadWinCount": 1,
    "games": [
      { "sequence": 1, "homeScoreLevel1": "2", "roadScoreLevel1": "0" },
      { "sequence": 2, "homeScoreLevel1": "2", "roadScoreLevel1": "0" },
      { "sequence": 3, "homeScoreLevel1": "0", "roadScoreLevel1": "2" }
    ]
  }
]

innings (basketball, with overtime)

"innings": [
  { "inningsNumber": 1, "homeScore": "13", "roadScore": "19", "overtime": false },
  { "inningsNumber": 2, "homeScore": "26", "roadScore": "18", "overtime": false },
  { "inningsNumber": 3, "homeScore": "9", "roadScore": "16", "overtime": false },
  { "inningsNumber": 4, "homeScore": "22", "roadScore": "17", "overtime": false },
  { "inningsNumber": 5, "homeScore": "6", "roadScore": "8", "overtime": true }
]

Errors

Standard shapes in §3.4.

4.9Get Full Fixture Details

Returns everything about one fixture: the fixture, venue, players in each game, and statistics.

Service type: Read — base URLs in §2.

/getFullFixtureDetails/[fixtureID].json

Request parameters

Response fields

An object.

Request / response example

GET https://api.leaguerepublic.com/json/getFullFixtureDetails/32609322.json

{
  "fixture": { "fixtureID": 32609322, "homeTeamName": "Kings Arms", "roadTeamName": "Moreton Arms", "homeScore": "3", "roadScore": "0", "result": true },
  "venue": { "venueName": "Kings Arms", "venueCity": null },
  "gameFormat": {
    "gameGroups": [
      {
        "gameGroupDesc": "sng",
        "games": [
          {
            "sequence": 1,
            "homeScoreLevel1": "1",
            "roadScoreLevel1": "0",
            "homePlayers": [
              { "firstName": "Cecil", "lastName": "O'Brian", "personID": 519405149, "playerNumber": 1, "squadNumber": null }
            ]
          }
        ]
      }
    ]
  },
  "homeLeagueStatTypes": [
    {
      "leagueStatTypeName": "180s",
      "statistics": [
        { "firstName": "Cecil", "lastName": "O'Brian", "personID": 519405149, "statisticValue": "2.00" }
      ]
    }
  ],
  "roadLeagueStatTypes": null
}

Trimmed. Example data is from the LeagueRepublic demo league.

Errors

Standard shapes in §3.4.

4.10Get Teams For Fixture Group

Returns the teams in a fixture group.

Service type: Read — base URLs in §2.

/getTeamsForFixtureGroup/[fixtureTypeID]/[fixtureGroupIdentifier].json

Request parameters

Response fields

A <List> of teams.

Request / response example

GET https://api.leaguerepublic.com/json/getTeamsForFixtureGroup/1/389974692.json

[
  { "teamID": 191899149, "teamName": "Arthurlie" }
]

Errors

Standard shapes in §3.4.

4.11Get Statistic Summary For Team

Returns player statistics and ratings for a team in a season. Game-format statistics are not included.

Service type: Read — base URLs in §2.

/getStatisticSummaryForTeam/[seasonID]/[teamID].json

Request parameters

Response fields

An object.

Request / response example

GET https://api.leaguerepublic.com/json/getStatisticSummaryForTeam/153020000/154033156.json

{
  "listCumulativePersonStatSummary": [
    {
      "firstName": "Michael",
      "handicapValue": null,
      "lastName": "Ferdinand",
      "leagueStatTypeID": 466651520,
      "leagueStatTypeName": "180s",
      "numberEntered": 1,
      "personID": 275084260,
      "statTypeValue": "1.00",
      "eloRating": null,
      "eloSeasonRating": null
    }
  ],
  "listNonCumulativePersonStatSummary": [
    {
      "firstName": "Michael",
      "handicapValue": null,
      "lastName": "Ferdinand",
      "leagueStatTypeID": 888557501,
      "leagueStatTypeName": "Least Darts Thrown",
      "personID": 275084260,
      "statTypeValue": "6.00",
      "eloRating": null,
      "eloSeasonRating": null
    }
  ]
}

Example data is from the LeagueRepublic demo league.

Errors

Standard shapes in §3.4.

5Obsolete and proposed services

None in this version. No services are obsolete or proposed.

6Reference data

6.1Appendix 1 — Fixture types (fixtureTypeID)

6.2Appendix 2 — Fixture status (fixtureStatus)

6.3Appendix 3 — Fixture date status (fixtureDateStatusID)

6.4Appendix 4 — Short codes (shortCode)

6.5Appendix 5 — Official positions (officialPositionID)

6.6Appendix 6 — Form letters (recentForm)

7Change log