<<< Back to User Guide

API introduction

FUMBBL has Application programming interface that can be used for getting various information from site for external use.

Following are examples for xml pages

• https://fumbbl.com/xml:group?id=2299&op=matches - all matches for a group
• https://fumbbl.com/xml:group?id=2299&op=tourneys - all tourney tables for a group
• https://fumbbl.com/xml:group?id=2299&op=members - all members for a group
• https://fumbbl.com/xml:group?id=195&op=matches&t=39226 - All or first page of played matches in group id and tournament t
• https://fumbbl.com/xml:group?id=195&op=matches&t=39226&paging=3741750 - Second page of the above query
• https://fumbbl.com/xml:group?id=195&op=matches&t=39226&paging=3733245&includeScheduled=1 - Including forfeited games

• https://fumbbl.com/xml:matches?id=552176 - First page of matches for a team (1-26)
• https://fumbbl.com/xml:matches?id=552176&p=2 - Second page of matches for a team (27-52)
• https://fumbbl.com/xml:matches?id=552176&p=3 - Third page of matches for a team (53-78)
• https://fumbbl.com/xml:matches?m=2018437 - a specific match
• https://fumbbl.com/xml:matches?p=2 - Second page of recent matches (27-52)
• https://fumbbl.com/xml:matches?c=3&p=2 - Second page of matches for a coach (27-52)

• https://fumbbl.com/xml:team?id=284314 - Team sheet information (with active players only)
• https://fumbbl.com/xml:team?id=284314&past=1 - Team sheet information (incl past players)

• https://fumbbl.com/xml:roster?id=16 - Roster definition for a Race
• https://fumbbl.com/xml:roster?division=1 - Valid rosters for a Division
• https://fumbbl.com/xml:roster?team=552176 - Roster for a Team (incl Star Players)
• https://fumbbl.com/xml:roster?team=552176&server=test - Roster for a Team (incl Star Players); this is what the FFB Test server gets

• https://fumbbl.com/xml:teams?coach=Christer - Team records as in the overview page

• https://fumbbl.com/xml:gamestate?op=check&team1=679456&team2=655758 - Game state of a scheduled match

Additions

The past players include Birthday-Zombies. These players do not have integer ID values!

• ID = "z_$team_id$:(1|2|3)"
• Zombies count as active although they do not appear on the roster.

For more information see: https://fumbbl.com/p/blog&c=gandresch&id=10678

NEW FUMBBL API

(source: https://fumbbl.com/index.php?name=PNphpBB2&file=viewtopic&t=25698)

Outputs JSON, unless /xml at the end, then XML

API Docs https://fumbbl.com/apidoc/

coach
commands: search
description: find coach(es) containing parameter or get teams of a specific coach
examples:
https://fumbbl.com/api/coach/search/Chris
https://fumbbl.com/api/coach/search/Chris/xml
https://fumbbl.com/api/coach/teams/Christer
https://fumbbl.com/api/coach/teams/Christer/xml

ruleset
commands: list, get
description: list all of your ruleset, or get a specific ruleset
examples:
https://fumbbl.com/api/ruleset/list
https://fumbbl.com/api/ruleset/list/xml
https://fumbbl.com/api/ruleset/get/303
https://fumbbl.com/api/ruleset/get/303/xml

roster
commands: get
description: get a specific roster
examples:
https://fumbbl.com/api/roster/get/6
https://fumbbl.com/api/roster/get/6/xml

position
commands: get
description: get a specific position
examples:
https://fumbbl.com/api/position/get/4247
https://fumbbl.com/api/position/get/4247/xml

team
commands: get
description: get information about a team (ruleset, league and all active players)
examples:
https://fumbbl.com/api/team/get/57340
https://fumbbl.com/api/team/get/57340/xml
https://fumbbl.com/api/team/matches/57340
https://fumbbl.com/api/team/matches/57340/xml

player
commands: get
description: get player by id.
examples:
https://fumbbl.com/api/player/get/4697130
https://fumbbl.com/api/player/get/4697130/xml

match
commands: get, list
description: get information about a match;list the most recent matches (starting from match_id (parameter)
examples:
https://fumbbl.com/api/match/get/4087298
https://fumbbl.com/api/match/get/4087298/xml
https://fumbbl.com/api/match/get/4087298?verbose=1
https://fumbbl.com/api/match/get/4087298/xml?verbose=1
https://fumbbl.com/api/match/list
https://fumbbl.com/api/match/list/xml
https://fumbbl.com/api/match/list/1000000
https://fumbbl.com/api/match/list/1000000/xml

group
commands: get, tournaments, teams
description: get information about group and tournaments
examples:
https://fumbbl.com/api/group/get/2299
https://fumbbl.com/api/group/get/2299/xml
https://fumbbl.com/api/group/tournaments/2299
https://fumbbl.com/api/group/tournaments/2299/xml
https://fumbbl.com/api/group/teams/2299
https://fumbbl.com/api/group/teams/2299/xml

tournament
commands: get, schedule
description: get information about tournament, schedule of tournament
examples:
https://fumbbl.com/api/tournament/get/51456
https://fumbbl.com/api/tournament/get/51456/xml
https://fumbbl.com/api/tournament/schedule/51456
https://fumbbl.com/api/tournament/schedule/51456/xml

dice
commands: get
description: get dice data for a match example:
https://fumbbl.com/p/match?op=stats&id=3916966