# LeagueRepublic JSON API — Interface Specification

| Version | Status | Date | Owner | Replaces |
|---|---|---|---|---|
| 1.4 | Approved | 6 October 2026 | LeagueRepublic (LR) | LeagueRepublic API Reference v1.3 (PDF, 8 November 2023) |

This document is the source of truth for the LeagueRepublic JSON API: every service, field, format, limit and error message. It is maintained by LeagueRepublic. Help Centre articles explain what you can build and link here for the detail. Version 1.4 adds two services (Get Match Hub and Get Fixtures For Team), adds new fields to fixtures, standings and games, and replaces the v1.3 PDF.

## **1  Introduction**

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.1  Identifiers**

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

| Identifier | What it is and where it comes from |
|---|---|
| `leagueID` | A league. Shown on Admin Home > API > API Settings. |
| `seasonID` | A season within a league. From Get Seasons For League. |
| `fixtureTypeID` | The kind of fixture group: 1 = division, 2 = competition (cup), 4 = other. See 6.1. |
| `fixtureGroupIdentifier` | A division, competition or other fixture group within a season. Always used together with `fixtureTypeID`. From Get Fixture Groups For Season. |
| `teamID` | A team. From Get Teams For Fixture Group, or `homeTeam` / `roadTeam` on any fixture. |
| `fixtureID` | A fixture (match). From any fixture list. |
| `personID` | A player or official. |
| `leagueStatTypeID` | A statistic type defined by the league, for example 180s or goals. |

## **2  Access 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.

| Environment | Read services — base URL | Write services — base URL |
|---|---|---|
| Live | `https://api.leaguerepublic.com/json/` | n/a |
| Test (LR only) | `http://leaguesites.test.leaguerepublic.com/json/` | n/a |

### **2.1  Rate 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.

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

## **3  Conventions**

### **3.1  URL 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.2  Data types and formats**

| Type | Meaning |
|---|---|
| int | Whole number, e.g. `236635540`. |
| bigint | Large whole number, used for milliseconds since 1 January 1970 UTC, e.g. `1790965800000`. |
| decimal | Number that may have a fraction, e.g. `66.7`. Standings figures are decimals. |
| varchar | Text. |
| boolean | `true` or `false`. |
| <List> | An array. May be empty (`[]`). |
| object | A nested set of fields. |

**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.3  Parameter 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.4  Return 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.

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

| Message | Meaning |
|---|---|
| `League is not authorised to access webservices` | The league is not on the Gold plan. |
| `JSON api is disabled for league` | Enable JSON API is not ticked in API Settings. |
| `Season does not exist for supplied season ID` | No season has that ID. |
| `Team does not exist for supplied team ID` | No team has that ID. |
| `Rate limit exceeded (HTTP 429)` | More than 60 requests a minute. See 2.1. |

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

## **4  Service reference**

**Service summary**

| § | Service | Path(s) | Type |
|---|---|---|---|
| 4.1 | Get Seasons For League | `/getSeasonsForLeague/[leagueID].json` | Read |
| 4.2 | Get Fixture Groups For Season | `/getFixtureGroupsForSeason/[seasonID].json` | Read |
| 4.3 | Get Standings For Fixture Group | `/getStandingsForFixtureGroup/[fixtureTypeID]/[fixtureGroupIdentifier].json` | Read |
| 4.4 | Get Fixtures For Season | `/getFixturesForSeason/[seasonID].json` | Read |
| 4.5 | Get Fixtures For Fixture Group | `/getFixturesForFixtureGroup/[fixtureTypeID]/[fixtureGroupIdentifier].json` | Read |
| 4.6 | Get Fixtures For Fixture Group Including Official Assignments | `/getFixturesForFixtureGroupIncludingOfficialAssignments/[fixtureTypeID]/[fixtureGroupIdentifier].json` | Read |
| 4.7 | Get Fixtures For Team (New in 1.4) | `/getFixturesForTeam/[seasonID]/[teamID].json` | Read |
| 4.8 | Get Match Hub (New in 1.4) | `/getMatchHub/[seasonID].json` `/getMatchHub/[seasonID]/[date].json` | Read |
| 4.9 | Get Full Fixture Details | `/getFullFixtureDetails/[fixtureID].json` | Read |
| 4.10 | Get Teams For Fixture Group | `/getTeamsForFixtureGroup/[fixtureTypeID]/[fixtureGroupIdentifier].json` | Read |
| 4.11 | Get Statistic Summary For Team | `/getStatisticSummaryForTeam/[seasonID]/[teamID].json` | Read |

### **4.1  Get Seasons For League**

Returns the league's seasons.

Service type: Read — base URLs in §2.

```
/getSeasonsForLeague/[leagueID].json
```

#### **Request parameters**

| Level | Field | Type | Required | Nullable | Notes |
|---|---|---|---|---|---|
| 1 | `leagueID` | int | Y |  | The league. |

#### **Response fields**

A <List> of seasons.

| Level | Field | Type | Required | Nullable | Notes |
|---|---|---|---|---|---|
| 1 | `seasonID` | int | Y |  |  |
| 1 | `seasonName` | varchar | Y |  | e.g. `"2026-2027"`. |
| 1 | `currentSeason` | boolean | Y |  | True for the season the league has marked as current. |
| 1 | `seasonStartDate` | varchar | Y |  | `yyyyMMdd HH:mm`. |
| 1 | `seasonStartDateInMilliseconds` | bigint | Y |  |  |
| 1 | `seasonEndDate` | varchar | Y |  | `yyyyMMdd HH:mm`. |
| 1 | `seasonEndDateInMilliseconds` | bigint | Y |  |  |

#### **Request / response example**

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

```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.2  Get 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**

| Level | Field | Type | Required | Nullable | Notes |
|---|---|---|---|---|---|
| 1 | `seasonID` | int | Y |  | The season. |

#### **Response fields**

A <List> of fixture groups.

| Level | Field | Type | Required | Nullable | Notes |
|---|---|---|---|---|---|
| 1 | `fixtureGroupDesc` | varchar | Y |  | Name, e.g. `"Premier Division"`. |
| 1 | `fixtureGroupIdentifier` | int | Y |  |  |
| 1 | `fixtureTypeID` | int | Y |  | See 6.1. |
| 1 | `fixtureTypeDesc` | varchar | Y |  | `"Division"`, `"Competition"` or `"Other Fixture Group"`. |

#### **Request / response example**

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

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

#### **Errors**

Standard shapes in §3.4.

### **4.3  Get 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**

| Level | Field | Type | Required | Nullable | Notes |
|---|---|---|---|---|---|
| 1 | `fixtureTypeID` | int | Y |  | 1 = division, 2 = competition. |
| 1 | `fixtureGroupIdentifier` | int | Y |  | The division or competition. |

#### **Response fields**

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

| Level | Field | Type | Required | Nullable | Notes |
|---|---|---|---|---|---|
| 1 | `standingsDesc` | varchar | Y |  | Table name, e.g. `"Premier Division"` or `"Group A"`. |
| 1 | `standingsLines <List>` | <List> | Y |  | One line per team, in position order. |
| 2 | `position` | varchar | Y |  | League position as text, e.g. `"1"`. |
| 2 | `teamID` | int | Y |  |  |
| 2 | `teamName` | varchar | Y |  |  |
| 2 | `points` | decimal | Y |  |  |
| 2 | `bonusPoints` | decimal | Y |  |  |
| 2 | `adjustmentMade` | varchar | Y | Y | Points adjustment, if any. |
| 2 | `scoreDifference` | decimal | Y |  | Score for minus score against. |
| 2 | `recentForm` | varchar | Y |  | Most recent results as letters, e.g. `"WLWWW"`. See 6.6. |
| 2 | `overallPlayed` | int | Y |  | All fixtures played. |
| 2 | `overallWon` | int | Y |  |  |
| 2 | `overallTied` | int | Y |  | Drawn. |
| 2 | `overallLoss` | int | Y |  |  |
| 2 | `overallScoreFor` | decimal | Y |  |  |
| 2 | `overallScoreAgainst` | decimal | Y |  |  |
| 2 | `overallScoreForLevel2` | decimal | Y |  | Second scoring level, for sports that have one (e.g. legs). 0 otherwise. |
| 2 | `overallScoreAgainstLevel2` | decimal | Y |  |  |
| 2 | `overallScoreForLevel3` | decimal | Y |  | Third scoring level. 0 if not used. |
| 2 | `overallScoreAgainstLevel3` | decimal | Y |  |  |
| 2 | `overallWinPercentage` | decimal | Y |  | Percentage, e.g. `66.7`. |
| 2 | `homePlayed` | int | Y |  | Home fixtures played. |
| 2 | `homeWon` | int | Y |  |  |
| 2 | `homeTied` | int | Y |  | Drawn. |
| 2 | `homeLoss` | int | Y |  |  |
| 2 | `homeScoreFor` | decimal | Y |  |  |
| 2 | `homeScoreAgainst` | decimal | Y |  |  |
| 2 | `homeScoreForLevel2` | decimal | Y |  | Second scoring level, for sports that have one (e.g. legs). 0 otherwise. |
| 2 | `homeScoreAgainstLevel2` | decimal | Y |  |  |
| 2 | `homeScoreForLevel3` | decimal | Y |  | Third scoring level. 0 if not used. |
| 2 | `homeScoreAgainstLevel3` | decimal | Y |  |  |
| 2 | `homeRecentForm` | varchar | Y |  | Home form letters. |
| 2 | `roadPlayed` | int | Y |  | Away fixtures played. |
| 2 | `roadWon` | int | Y |  |  |
| 2 | `roadTied` | int | Y |  | Drawn. |
| 2 | `roadLoss` | int | Y |  |  |
| 2 | `roadScoreFor` | decimal | Y |  |  |
| 2 | `roadScoreAgainst` | decimal | Y |  |  |
| 2 | `roadScoreForLevel2` | decimal | Y |  | Second scoring level, for sports that have one (e.g. legs). 0 otherwise. |
| 2 | `roadScoreAgainstLevel2` | decimal | Y |  |  |
| 2 | `roadScoreForLevel3` | decimal | Y |  | Third scoring level. 0 if not used. |
| 2 | `roadScoreAgainstLevel3` | decimal | Y |  |  |
| 2 | `roadRecentForm` | varchar | Y |  | Away form letters. |

#### **Request / response example**

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

```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.4  Get 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**

| Level | Field | Type | Required | Nullable | Notes |
|---|---|---|---|---|---|
| 1 | `seasonID` | int | Y |  | The season. |

#### **Response fields**

A <List> of fixtures.

| Level | Field | Type | Required | Nullable | Notes |
|---|---|---|---|---|---|
| 1 | `fixtureID` | int | Y |  | The fixture's ID. |
| 1 | `fixtureDate` | varchar | Y |  | Local date and time, `yyyyMMdd HH:mm`. |
| 1 | `fixtureDateInMilliseconds` | bigint | Y |  | Same moment, milliseconds since 1 Jan 1970 UTC. |
| 1 | `fixtureDateStatusID` | int | Y |  | Whether the date is fixed. See 6.3. |
| 1 | `fixtureDateStatusDesc` | varchar | Y |  | Description of `fixtureDateStatusID`. |
| 1 | `fixtureStatus` | int | Y |  | Whether the fixture is going ahead. See 6.2. |
| 1 | `fixtureStatusDesc` | varchar | Y |  | Description of `fixtureStatus`. |
| 1 | `fixtureGroupDesc` | varchar | Y |  | Name of the division or competition. |
| 1 | `fixtureGroupIdentifier` | int | Y |  | Its ID. Use with `fixtureTypeID`. |
| 1 | `fixtureTypeID` | int | Y |  | See 6.1. |
| 1 | `homeTeam` | int | Y |  | Home team's ID. |
| 1 | `homeTeamName` | varchar | Y |  | Home team's name. |
| 1 | `roadTeam` | int | Y |  | Away team's ID. |
| 1 | `roadTeamName` | varchar | Y |  | Away team's name. |
| 1 | `homeScore` | varchar | Y | Y | Home score as text. Null if not played. |
| 1 | `roadScore` | varchar | Y | Y | Away score as text. Null if not played. |
| 1 | `homeScoreNote` | varchar | Y | Y | Note shown next to the home score. |
| 1 | `roadScoreNote` | varchar | Y | Y | Note shown next to the away score. |
| 1 | `additionalScore` | varchar | Y | Y | Extra detail such as `"(HT 2-0)"` or `"(Pens 4-5)"`. |
| 1 | `result` | boolean | Y |  | True if the fixture has a result. |
| 1 | `noResultOutcome` | boolean | Y |  | True if recorded as having no result. |
| 1 | `fixtureNote` | varchar | Y | Y | Match note, only when the league chooses to show it. |
| 1 | `roundDesc` | varchar | Y | Y | Cup round, e.g. `"Final"`. Null for divisions. |
| 1 | `shortCode` | varchar | Y |  | One-letter type code. See 6.4. |
| 1 | `venueAndSubVenueDesc` | varchar | Y | Y | Venue, plus pitch or court if set. |
| 1 | `officialAssignments` | <List> | Y | Y | Always null here. Use Get Fixtures For Fixture Group Including Official Assignments. |

#### **Request / response example**

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

```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.5  Get 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**

| Level | Field | Type | Required | Nullable | Notes |
|---|---|---|---|---|---|
| 1 | `fixtureTypeID` | int | Y |  | See 6.1. |
| 1 | `fixtureGroupIdentifier` | int | Y |  | The fixture group. |

#### **Response fields**

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

| Level | Field | Type | Required | Nullable | Notes |
|---|---|---|---|---|---|
| 1 | `fixtureID` | int | Y |  | The fixture's ID. |
| 1 | `fixtureDate` | varchar | Y |  | Local date and time, `yyyyMMdd HH:mm`. |
| 1 | `fixtureDateInMilliseconds` | bigint | Y |  | Same moment, milliseconds since 1 Jan 1970 UTC. |
| 1 | `fixtureDateStatusID` | int | Y |  | Whether the date is fixed. See 6.3. |
| 1 | `fixtureDateStatusDesc` | varchar | Y |  | Description of `fixtureDateStatusID`. |
| 1 | `fixtureStatus` | int | Y |  | Whether the fixture is going ahead. See 6.2. |
| 1 | `fixtureStatusDesc` | varchar | Y |  | Description of `fixtureStatus`. |
| 1 | `homeTeam` | int | Y |  | Home team's ID. |
| 1 | `homeTeamName` | varchar | Y |  | Home team's name. |
| 1 | `roadTeam` | int | Y |  | Away team's ID. |
| 1 | `roadTeamName` | varchar | Y |  | Away team's name. |
| 1 | `homeScore` | varchar | Y | Y | Home score as text. Null if not played. |
| 1 | `roadScore` | varchar | Y | Y | Away score as text. Null if not played. |
| 1 | `homeScoreNote` | varchar | Y | Y | Note shown next to the home score. |
| 1 | `roadScoreNote` | varchar | Y | Y | Note shown next to the away score. |
| 1 | `additionalScore` | varchar | Y | Y | Extra detail such as `"(HT 2-0)"` or `"(Pens 4-5)"`. |
| 1 | `result` | boolean | Y |  | True if the fixture has a result. |
| 1 | `noResultOutcome` | boolean | Y |  | True if recorded as having no result. |
| 1 | `fixtureNote` | varchar | Y | Y | Match note, only when the league chooses to show it. |
| 1 | `roundDesc` | varchar | Y | Y | Cup round, e.g. `"Final"`. Null for divisions. |
| 1 | `shortCode` | varchar | Y |  | One-letter type code. See 6.4. |
| 1 | `venueAndSubVenueDesc` | varchar | Y | Y | Venue, plus pitch or court if set. |

#### **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.6  Get 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**

| Level | Field | Type | Required | Nullable | Notes |
|---|---|---|---|---|---|
| 1 | `fixtureTypeID` | int | Y |  | See 6.1. |
| 1 | `fixtureGroupIdentifier` | int | Y |  | The fixture group. |

#### **Response fields**

A <List> of fixtures.

| Level | Field | Type | Required | Nullable | Notes |
|---|---|---|---|---|---|
| 1 | `fixtureID` | int | Y |  | The fixture's ID. |
| 1 | `fixtureDate` | varchar | Y |  | Local date and time, `yyyyMMdd HH:mm`. |
| 1 | `fixtureDateInMilliseconds` | bigint | Y |  | Same moment, milliseconds since 1 Jan 1970 UTC. |
| 1 | `fixtureDateStatusID` | int | Y |  | Whether the date is fixed. See 6.3. |
| 1 | `fixtureDateStatusDesc` | varchar | Y |  | Description of `fixtureDateStatusID`. |
| 1 | `fixtureStatus` | int | Y |  | Whether the fixture is going ahead. See 6.2. |
| 1 | `fixtureStatusDesc` | varchar | Y |  | Description of `fixtureStatus`. |
| 1 | `fixtureGroupDesc` | varchar | Y |  | Name of the division or competition. |
| 1 | `fixtureGroupIdentifier` | int | Y |  | Its ID. Use with `fixtureTypeID`. |
| 1 | `fixtureTypeID` | int | Y |  | See 6.1. |
| 1 | `homeTeam` | int | Y |  | Home team's ID. |
| 1 | `homeTeamName` | varchar | Y |  | Home team's name. |
| 1 | `roadTeam` | int | Y |  | Away team's ID. |
| 1 | `roadTeamName` | varchar | Y |  | Away team's name. |
| 1 | `homeScore` | varchar | Y | Y | Home score as text. Null if not played. |
| 1 | `roadScore` | varchar | Y | Y | Away score as text. Null if not played. |
| 1 | `homeScoreNote` | varchar | Y | Y | Note shown next to the home score. |
| 1 | `roadScoreNote` | varchar | Y | Y | Note shown next to the away score. |
| 1 | `additionalScore` | varchar | Y | Y | Extra detail such as `"(HT 2-0)"` or `"(Pens 4-5)"`. |
| 1 | `result` | boolean | Y |  | True if the fixture has a result. |
| 1 | `noResultOutcome` | boolean | Y |  | True if recorded as having no result. |
| 1 | `fixtureNote` | varchar | Y | Y | Match note, only when the league chooses to show it. |
| 1 | `roundDesc` | varchar | Y | Y | Cup round, e.g. `"Final"`. Null for divisions. |
| 1 | `shortCode` | varchar | Y |  | One-letter type code. See 6.4. |
| 1 | `venueAndSubVenueDesc` | varchar | Y | Y | Venue, plus pitch or court if set. |
| 1 | `officialAssignments <List>` | <List> | Y | Y | Officials assigned. Null if none. |
| 2 | `firstName` | varchar | Y |  |  |
| 2 | `lastName` | varchar | Y |  |  |
| 2 | `officialPositionID` | int | Y |  | See 6.5. |

#### **Request / response example**

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

```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.7  Get 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**

| Level | Field | Type | Required | Nullable | Notes |
|---|---|---|---|---|---|
| 1 | `seasonID` | int | Y |  | The season. |
| 1 | `teamID` | int | Y |  | The team. |

#### **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.

| Level | Field | Type | Required | Nullable | Notes |
|---|---|---|---|---|---|
| 1 | `fixtureID` | int | Y |  | The fixture's ID. |
| 1 | `fixtureDate` | varchar | Y |  | Local date and time, `yyyyMMdd HH:mm`. |
| 1 | `fixtureDateInMilliseconds` | bigint | Y |  | Same moment, milliseconds since 1 Jan 1970 UTC. |
| 1 | `fixtureDateStatusID` | int | Y |  | Whether the date is fixed. See 6.3. |
| 1 | `fixtureDateStatusDesc` | varchar | Y |  | Description of `fixtureDateStatusID`. |
| 1 | `fixtureStatus` | int | Y |  | Whether the fixture is going ahead. See 6.2. |
| 1 | `fixtureStatusDesc` | varchar | Y |  | Description of `fixtureStatus`. |
| 1 | `fixtureGroupDesc` | varchar | Y |  | Name of the division or competition. |
| 1 | `fixtureGroupIdentifier` | int | Y |  | Its ID. Use with `fixtureTypeID`. |
| 1 | `fixtureTypeID` | int | Y |  | See 6.1. |
| 1 | `homeTeam` | int | Y |  | Home team's ID. |
| 1 | `homeTeamName` | varchar | Y |  | Home team's name. |
| 1 | `roadTeam` | int | Y |  | Away team's ID. |
| 1 | `roadTeamName` | varchar | Y |  | Away team's name. |
| 1 | `homeScore` | varchar | Y | Y | Home score as text. Null if not played. |
| 1 | `roadScore` | varchar | Y | Y | Away score as text. Null if not played. |
| 1 | `homeScoreNote` | varchar | Y | Y | Note shown next to the home score. |
| 1 | `roadScoreNote` | varchar | Y | Y | Note shown next to the away score. |
| 1 | `additionalScore` | varchar | Y | Y | Extra detail such as `"(HT 2-0)"` or `"(Pens 4-5)"`. |
| 1 | `result` | boolean | Y |  | True if the fixture has a result. |
| 1 | `noResultOutcome` | boolean | Y |  | True if recorded as having no result. |
| 1 | `fixtureNote` | varchar | Y | Y | Match note, only when the league chooses to show it. |
| 1 | `roundDesc` | varchar | Y | Y | Cup round, e.g. `"Final"`. Null for divisions. |
| 1 | `shortCode` | varchar | Y |  | One-letter type code. See 6.4. |
| 1 | `venueAndSubVenueDesc` | varchar | Y | Y | Venue, plus pitch or court if set. |

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
```

```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.

| Message | Meaning |
|---|---|
| `Supplied seasonID or teamID is not numeric` | An ID contains letters or symbols. |

### **4.8  Get 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**

| Level | Field | Type | Required | Nullable | Notes |
|---|---|---|---|---|---|
| 1 | `seasonID` | int | Y |  | The season. |
| 1 | `date` | varchar | N |  | Optional. `yyyyMMdd`, or `tbc` for fixtures with no date yet. Omitted: the day the Match Hub page opens on. |

#### **Response fields**

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

| Level | Field | Type | Required | Nullable | Notes |
|---|---|---|---|---|---|
| 1 | `seasonID` | int | Y |  | The season requested. |
| 1 | `seasonList <List>` | <List> | Y |  | All the league's seasons. |
| 2 | `seasonID` | int | Y |  |  |
| 2 | `seasonName` | varchar | Y |  |  |
| 1 | `matchHubDate` | varchar | Y |  | The day returned, `yyyyMMdd`, or `"tbc"`. |
| 1 | `matchHubRecapContentText` | varchar | Y | Y | Written round-up of the day, if the league uses recaps. |
| 1 | `matchHubRecapLoadDateTime` | bigint | Y | Y | When the round-up was written, as milliseconds since 1 Jan 1970 UTC. |
| 1 | `dateList <List>` | <List> | Y |  | Every match day in the season, in date order. A final `"tbc"` entry holds undated fixtures. |
| 2 | `matchHubDate` | varchar | Y |  | `yyyyMMdd` or `"tbc"`. |
| 2 | `matchCount` | int | Y |  | Unplayed fixtures that day. |
| 2 | `resultCount` | int | Y | Y | Fixtures with a result. Null on the tbc entry. |
| 2 | `liveResultCount` | int | Y | Y | Fixtures with a live score. Null unless live results are used. |
| 1 | `fixtureGroupList <List>` | <List> | Y |  | The day's fixtures, grouped by division, cup round or other group. |
| 2 | `fixtureGroupDesc` | varchar | Y |  | e.g. `"Premier Division"`, `"Scottish Cup - Round 1"`. |
| 2 | `fixtureGroupIdentifier` | int | Y |  | For a division, the division's ID. Known issue: for a cup round it is the round's ID, not the competition ID used by other services. Use `fixtureGroupDesc` to label it. |
| 2 | `fixtureTypeID` | int | Y |  | See 6.1. |
| 2 | `fixtures <List>` | <List> | Y |  | Fixture fields below. Same names as Get Fixtures For Season. |
| 3 | `fixtureID` | int | Y |  | The fixture's ID. |
| 3 | `fixtureDate` | varchar | Y |  | Local date and time, `yyyyMMdd HH:mm`. |
| 3 | `fixtureDateInMilliseconds` | bigint | Y |  | Same moment, milliseconds since 1 Jan 1970 UTC. |
| 3 | `fixtureDateStatusID` | int | Y |  | Whether the date is fixed. See 6.3. |
| 3 | `fixtureDateStatusDesc` | varchar | Y |  | Description of `fixtureDateStatusID`. |
| 3 | `fixtureStatus` | int | Y |  | Whether the fixture is going ahead. See 6.2. |
| 3 | `fixtureStatusDesc` | varchar | Y |  | Description of `fixtureStatus`. |
| 3 | `homeTeam` | int | Y |  | Home team's ID. |
| 3 | `homeTeamName` | varchar | Y |  | Home team's name. |
| 3 | `roadTeam` | int | Y |  | Away team's ID. |
| 3 | `roadTeamName` | varchar | Y |  | Away team's name. |
| 3 | `homeScore` | varchar | Y | Y | Home score as text. Null if not played. |
| 3 | `roadScore` | varchar | Y | Y | Away score as text. Null if not played. |
| 3 | `homeScoreNote` | varchar | Y | Y | Note shown next to the home score. |
| 3 | `roadScoreNote` | varchar | Y | Y | Note shown next to the away score. |
| 3 | `additionalScore` | varchar | Y | Y | Extra detail such as `"(HT 2-0)"` or `"(Pens 4-5)"`. |
| 3 | `result` | boolean | Y |  | True if the fixture has a result. |
| 3 | `noResultOutcome` | boolean | Y |  | True if recorded as having no result. |
| 3 | `fixtureNote` | varchar | Y | Y | Match note, only when the league chooses to show it. |
| 3 | `roundDesc` | varchar | Y | Y | Cup round, e.g. `"Final"`. Null for divisions. |
| 3 | `shortCode` | varchar | Y |  | One-letter type code. See 6.4. |
| 3 | `venueAndSubVenueDesc` | varchar | Y | Y | Venue, plus pitch or court if set. |
| 3 | `approved` | boolean | Y |  | True once the league has approved the result. Unapproved and live results are included. |
| 3 | `matchInsightsExist` | boolean | Y |  | True if a match preview exists on the league's website. |
| 3 | `liveLastUpdated` | varchar | Y | Y | Display text such as `"Updated 12 minutes ago"`. Not a timestamp: show it as it is rather than parsing it. Null unless live results are used. |
| 3 | `liveSourceDesc` | varchar | Y | Y | Where the live score came from. Null unless live results are used. |
| 3 | `homeScoreHits` | int | Y | Y | Softball and baseball only. |
| 3 | `homeScoreErrors` | int | Y | Y | Softball and baseball only. |
| 3 | `roadScoreHits` | int | Y | Y | Softball and baseball only. |
| 3 | `roadScoreErrors` | int | Y | Y | Softball and baseball only. |
| 3 | `gameGroups <List>` | <List> | Y | Y | Games within the match (darts, pool, snooker). Null for other sports and unplayed fixtures. |
| 4 | `gameGroupDesc` | varchar | Y |  | Game type, e.g. `"Pairs"`. |
| 4 | `gameGroupDescShort` | varchar | Y |  | Short name, e.g. `"PRS"`. |
| 4 | `homeWinCount` | int | Y |  | Games of this type won by the home side. |
| 4 | `roadWinCount` | int | Y |  | Games of this type won by the away side. |
| 4 | `games <List>` | <List> | Y |  | Each game, in order. No player names: use Get Full Fixture Details. |
| 5 | `sequence` | int | Y |  | Order of the game: 1 = first. |
| 5 | `homeScoreLevel1` | varchar | Y |  | Home score for the game, e.g. legs or frames. |
| 5 | `roadScoreLevel1` | varchar | Y |  | Away score for the game. |
| 3 | `innings <List>` | <List> | Y | Y | Score by innings, quarter or period. Null for sports that do not use them. |
| 4 | `inningsNumber` | int | Y |  | Order: 1 = first. |
| 4 | `homeScore` | varchar | Y |  | Home score in that period. |
| 4 | `roadScore` | varchar | Y |  | Away score in that period. |
| 4 | `overtime` | boolean | Y |  | True for an overtime period. Number them by counting overtime entries in order. |
| 2 | `standings` | object | Y | Y | The division's table. For a group-stage cup round, one group's table (known issue: only one group is returned). Null for knockout cup rounds and other groups. |
| 3 | `standingsDesc` | varchar | Y |  |  |
| 3 | `standingsLines <List>` | <List> | Y |  | Same fields as Get Standings For Fixture Group. |

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
```

```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)**

```json
"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)**

```json
"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.

| Message | Meaning |
|---|---|
| `Supplied seasonID is not numeric` | The season ID contains letters or symbols. |
| `Supplied date is not valid, expected format yyyyMMdd or tbc` | The date is not `yyyyMMdd` or `tbc`, or is not a real date. |

### **4.9  Get 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**

| Level | Field | Type | Required | Nullable | Notes |
|---|---|---|---|---|---|
| 1 | `fixtureID` | int | Y |  | The fixture. |

#### **Response fields**

An object.

| Level | Field | Type | Required | Nullable | Notes |
|---|---|---|---|---|---|
| 1 | `fixture` | object | Y |  | The fixture. Same fields as Get Fixtures For Season, with `officialAssignments`. |
| 1 | `venue` | object | Y | Y |  |
| 2 | `venueName` | varchar | Y |  |  |
| 2 | `venueAddr1` | varchar | Y | Y |  |
| 2 | `venueAddr2` | varchar | Y | Y |  |
| 2 | `venueAddr3` | varchar | Y | Y |  |
| 2 | `venueCity` | varchar | Y | Y |  |
| 2 | `venueCounty` | varchar | Y | Y |  |
| 2 | `venueState` | varchar | Y | Y |  |
| 2 | `venueZipOrPostCode` | varchar | Y | Y |  |
| 2 | `venueDir` | varchar | Y | Y | Directions. |
| 2 | `contactPhoneNumber` | varchar | Y | Y |  |
| 1 | `availableHomePlayers <List>` | <List> | Y | Y | Players available to the home team. |
| 2 | `personID` | int | Y |  |  |
| 2 | `firstName` | varchar | Y |  |  |
| 2 | `lastName` | varchar | Y |  |  |
| 2 | `handicapValue` | varchar | Y | Y | Player handicap, if the league uses handicaps. |
| 1 | `availableRoadPlayers <List>` | <List> | Y | Y | As `availableHomePlayers`. |
| 1 | `gameFormat` | object | Y | Y | Leagues with several games per match (darts, pool). Null otherwise. |
| 2 | `gameGroups <List>` | <List> | Y |  |  |
| 3 | `gameGroupDesc` | varchar | Y |  |  |
| 3 | `games <List>` | <List> | Y |  |  |
| 4 | `sequence` | int | Y |  | Order of the game: 1 = first. |
| 4 | `homeScoreLevel1` | varchar | Y |  |  |
| 4 | `roadScoreLevel1` | varchar | Y |  |  |
| 4 | `homePlayers <List>` | <List> | Y |  | Players in the game. |
| 5 | `firstName` | varchar | Y |  |  |
| 5 | `lastName` | varchar | Y |  |  |
| 5 | `personID` | int | Y |  |  |
| 5 | `playerNumber` | int | Y | Y | Player's number in the game, e.g. 1 or 2 in pairs. |
| 5 | `squadNumber` | int | Y | Y | Shirt or squad number, if set. |
| 4 | `roadPlayers <List>` | <List> | N |  | As `homePlayers`. Omitted when empty. |
| 1 | `homeLeagueStatTypes <List>` | <List> | Y | Y | Home team statistics, by statistic type. |
| 2 | `leagueStatTypeName` | varchar | Y |  | e.g. `"180s"`. |
| 2 | `statistics <List>` | <List> | Y |  |  |
| 3 | `firstName` | varchar | Y |  |  |
| 3 | `lastName` | varchar | Y |  |  |
| 3 | `personID` | int | Y |  |  |
| 3 | `statisticValue` | varchar | Y |  | e.g. `"2.00"`. |
| 1 | `roadLeagueStatTypes <List>` | <List> | Y | Y | As `homeLeagueStatTypes`. |

#### **Request / response example**

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

```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.10  Get Teams For Fixture Group**

Returns the teams in a fixture group.

Service type: Read — base URLs in §2.

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

#### **Request parameters**

| Level | Field | Type | Required | Nullable | Notes |
|---|---|---|---|---|---|
| 1 | `fixtureTypeID` | int | Y |  | See 6.1. |
| 1 | `fixtureGroupIdentifier` | int | Y |  | The fixture group. |

#### **Response fields**

A <List> of teams.

| Level | Field | Type | Required | Nullable | Notes |
|---|---|---|---|---|---|
| 1 | `teamID` | int | Y |  |  |
| 1 | `teamName` | varchar | Y |  |  |

#### **Request / response example**

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

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

#### **Errors**

Standard shapes in §3.4.

### **4.11  Get 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**

| Level | Field | Type | Required | Nullable | Notes |
|---|---|---|---|---|---|
| 1 | `seasonID` | int | Y |  | The season. |
| 1 | `teamID` | int | Y |  | The team. |

#### **Response fields**

An object.

| Level | Field | Type | Required | Nullable | Notes |
|---|---|---|---|---|---|
| 1 | `listCumulativePersonStatSummary <List>` | <List> | Y |  | One entry per player per statistic type. Players with no statistics yet appear once, with the statistic fields null. |
| 2 | `personID` | int | Y |  |  |
| 2 | `firstName` | varchar | Y |  |  |
| 2 | `lastName` | varchar | Y |  |  |
| 2 | `leagueStatTypeID` | int | Y | Y | Null for a player with no statistics yet. |
| 2 | `leagueStatTypeName` | varchar | Y | Y | e.g. `"180s"`. |
| 2 | `statTypeValue` | varchar | Y | Y | Total, e.g. `"1.00"`. |
| 2 | `numberEntered` | int | Y |  | How many times it was recorded. 0 if none. |
| 2 | `handicapValue` | varchar | Y | Y |  |
| 2 | `eloRating` | int | Y | Y | The player's rating across all seasons, if the league uses ratings. |
| 2 | `eloSeasonRating` | int | Y | Y | The player's rating for this season. |
| 1 | `listNonCumulativePersonStatSummary <List>` | <List> | Y |  | Statistics that are not added up, such as a best or lowest value. One entry per player per statistic type. |
| 2 | `personID` | int | Y |  |  |
| 2 | `firstName` | varchar | Y |  |  |
| 2 | `lastName` | varchar | Y |  |  |
| 2 | `leagueStatTypeID` | int | Y |  |  |
| 2 | `leagueStatTypeName` | varchar | Y |  | e.g. `"Least Darts Thrown"`. |
| 2 | `statTypeValue` | varchar | Y |  | The value, e.g. `"6.00"`. |
| 2 | `handicapValue` | varchar | Y | Y |  |
| 2 | `eloRating` | int | Y | Y |  |
| 2 | `eloSeasonRating` | int | Y | Y |  |

#### **Request / response example**

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

```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.

## **5  Obsolete and proposed services**

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

## **6  Reference data**

### **6.1  Appendix 1 — Fixture types (fixtureTypeID)**

| Value | Description |
|---|---|
| `1` | Division |
| `2` | Competition (cup) |
| `4` | Other fixture group |

### **6.2  Appendix 2 — Fixture status (fixtureStatus)**

| Value | Description |
|---|---|
| `0` | Normal |
| `2` | Postponed |
| `3` | Home Walkover |
| `Other` | Further values may appear. Show `fixtureStatusDesc` rather than mapping the number yourself. |

### **6.3  Appendix 3 — Fixture date status (fixtureDateStatusID)**

| Value | Description |
|---|---|
| `1` | Normal / Scheduled |
| `2` | To Be Confirmed. These fixtures appear in Get Match Hub only when `tbc` is requested. |

### **6.4  Appendix 4 — Short codes (shortCode)**

| Value | Description |
|---|---|
| `L` | League (division) |
| `C` | Cup (competition) |
| `O` | Other |

### **6.5  Appendix 5 — Official positions (officialPositionID)**

| Value | Description |
|---|---|
| `1` | Referee (the main official) |
| `2–8` | Additional officials, such as assistant referees. Up to 8 per fixture. |

### **6.6  Appendix 6 — Form letters (recentForm)**

| Value | Description |
|---|---|
| `W` | Won |
| `D` | Drawn |
| `L` | Lost |

## **7  Change log**

| Version | Changed by | Date | Change |
|---|---|---|---|
| 1.3 | LR | 8 Nov 2023 | PDF reference covering nine services. |
| 1.4 | Angelo Kyeremateng | 6 Oct 2026 | Replaces the PDF with this specification. Adds Get Match Hub and Get Fixtures For Team. Adds `homeTeam` / `roadTeam` to fixtures; `homeScoreForLevel2/3` and `roadScoreFor`, `roadScoreForLevel2/3` to standings; `sequence` to games; `personID`, `playerNumber`, `squadNumber` to game players. Documents fields the v1.3 PDF left out (`eloRating`, `eloSeasonRating`, `listNonCumulativePersonStatSummary`, `handicapValue` on available players, fixture group fields on the officials list, fixture status 3), the rate limit and the error shapes. |