/scheduleSchedule
Fixtures grouped by match day, then by phase or bracket section.
| Name | Type | Description |
|---|---|---|
| league | uuid | Only fixtures of this league. |
| division | string | Division NAME as the public pages show it (URL-encoded). |
| round | uuid | Only fixtures of this round (phase id). |
| date | yyyy-mm-dd | all | One UTC match day, or every day. Absent = every day. |
| Field | Type | Description |
|---|---|---|
| tournament | object | id, name, format, status. |
| days[].date | string | null | UTC match day; null = TBC. |
| days[].label | string | Display label, e.g. "Sat 19 Sep". |
| days[].sections[] | object[] | Phase or bracket groups. |
| …sections[].kind | "phase" | "bracket" | Whether the section is a league/group round or a knockout bracket. |
| …sections[].title | string | Round name, or the bracket name for knockouts. |
| …sections[].phaseId / phaseType / roundNumber | uuid | string | number | null | Round context; null on bracket sections. |
| …sections[].divisionName / leagueName | string | null | Division and league the section belongs to; null on bracket sections. |
| …sections[].bracketId | uuid | null | The bracket id; null on phase sections. |
| …sections[].matches[] | object[] | The fixtures, below. |
| …matches[].id | uuid | Pass to /matches/{matchId}. |
| …matches[].source | "league" | "bracket" | League/group fixture or cup knockout fixture. |
| …matches[].status | string | scheduled | in_progress | completed | abandoned. |
| …matches[].scheduledAt | string | null | Wall-clock time stored as UTC. |
| …matches[].matchNo | number | null | Organiser-set Match No. (null when not numbered). Within a section, numbered matches come first by this number, then the rest by time. |
| …matches[].homeTeam / awayTeam | { id, name } | null | null while a knockout slot is still undecided. |
| …matches[].homeScore / awayScore | number | null | null until a score is recorded. |
| …matches[].homePenalties / awayPenalties | number | null | Penalty shoot-out result; knockout matches only, otherwise null. |
| …matches[].winnerId | uuid | null | Winning team id for knockout matches; null for league fixtures. |
| …matches[].venue | { id, name, address } | null | Location: the venue where the match is played; address may be null. |
| …matches[].pitch | { id, name } | null | Location detail: the pitch within the venue (e.g. "Pitch 1"). |
| …matches[].phaseId / phaseName / phaseType / roundNumber | uuid | string | number | null | League round context (phaseId is the round id); null for knockout. |
| …matches[].divisionId / divisionName | uuid | string | null | Division the match resolves to; null for knockout. |
| …matches[].leagueId / leagueName | uuid | string | null | League the match resolves to; null for knockout. |
| …matches[].bracketId / bracketName | uuid | string | null | Bracket context; null for league fixtures. |
| …matches[].round / matchNumber | number | null | Knockout round and bracket position (not the organiser Match No.); null for league fixtures. |
| totalMatches | number | Fixtures across all returned days. |
Errors: 403 origin_not_allowed · 404 tournament_not_found
curl -s \
-H "Origin: https://scoreboard.example" \
"https://your-fixturepro-domain/api/public/tournaments/{tournamentId}/schedule?division=Division%201&date=2026-09-26"const res = await fetch('https://your-fixturepro-domain/api/public/tournaments/{tournamentId}/schedule?division=Division%201&date=2026-09-26')
const { data } = await res.json(){
"success": true,
"data": {
"tournament": { "id": "t-uuid", "name": "Autumn Cup", "format": "league", "status": "ongoing" },
"days": [{
"date": "2026-09-26",
"label": "Sat 26 Sep",
"sections": [{
"kind": "phase", "title": "Round 1", "phaseId": "round-uuid", "phaseType": "league",
"roundNumber": 1, "divisionName": "Division 1", "leagueName": "Under-15 Male", "bracketId": null,
"matches": [{
"id": "match-uuid", "source": "league", "status": "in_progress",
"scheduledAt": "2026-09-26T09:00:00.000Z", "matchNo": 1,
"homeScore": 2, "awayScore": 1,
"homePenalties": null, "awayPenalties": null, "winnerId": null,
"homeTeam": { "id": "team-uuid", "name": "Arsenal A" },
"awayTeam": { "id": "team-uuid-2", "name": "Chelsea A" },
"venue": { "id": "venue-uuid", "name": "River Valley HS", "address": "1 Stadium Rd" },
"pitch": { "id": "pitch-uuid", "name": "Pitch 1" },
"phaseId": "round-uuid", "phaseName": "Round 1", "phaseType": "league", "roundNumber": 1,
"divisionName": "Division 1", "divisionId": "div-uuid",
"leagueName": "Under-15 Male", "leagueId": "league-uuid",
"bracketId": null, "bracketName": null, "round": null, "matchNumber": null
}]
}]
}],
"totalMatches": 1
},
"error": null,
"meta": { "generatedAt": "2026-10-24T02:30:00.000Z" }
}