Introduction
Sportradar’s UFL API offers a comprehensive suite of game and seasonal stats. Whether you are looking for the fastest gameday updates or your favorite player’s season stats, Sportradar has you covered.
All game data feeds update in real-time as games are played and are compiled via expert Sportradar in-house operators. All UFL games feature full play-by-play coverage.
Primary feeds will return schedules, standings, team/player data, and real-time scores.
Additional feeds provide a host of complementary stats, including:
- Team rosters
- Standings
- Depth charts
- Weekly injuries
- Seasonal statistics
Real-time customers are also offered two delivery Push Feeds to enhance speed.
Authentication is required for all API calls.
API Map
To best utilize the UFL API v7, you will need several parameters to create your API calls. The map below illustrates how you can obtain the parameters you need.
Primary and additional feeds only require dates or human-readable parameters, while other feeds require a global unique identifier (GUID) to identify the game, team, or player that the feed will describe. The primary feeds provide GUIDs for games and teams, while games and teams provide GUIDS for players.
Endpoint Descriptions
Current Season Schedule – Provides schedule information for the current season, including venue and broadcast info, and scoring results by quarter.
Current Week Schedule – Provides schedule information for the current week, including venue and broadcast info, and scoring results by quarter.
Daily Change Log – Provides IDs and timestamps for teams, players, game statistics, schedules, and standings that have been modified on a given date. To receive the data updates, use these unique IDs to pull relevant API feeds.
Daily Transactions – Provides information for all transactions added or edited during the league-defined day.
Game Boxscore – Provides game scoring information for each team, including complete play-by-play information for all scoring drives.
Game Roster – Provides complete game roster information for each team, including game status and player profile data.
Game Statistics – Provides extensive team and player level game statistics for each team.
League Hierarchy – Provides top-level information for each team, including division distinction.
Play-by-Play – Provides a live play-by-play timeline, including possession and location information as well as all team and player statistics earned on each play.
Player Profile – Provides player biographical information and seasonal statistics.
Postgame Standings – Provides standings information for each team, updated postgame.
Season Schedule – Provides complete schedule information for a given season, including venue and broadcast info, and scoring results by quarter.
Seasonal Statistics – Provides complete team and player seasonal statistics for a given season and season type.
Seasons – Provides a list of all available seasons in the API.
Team Roster – Provides franchise team information, as well as the complete roster of players.
Teams – Provides a complete list of active teams in the UFL API database.
Tournament List – Provides a summarized list of all tournaments scheduled for the given season.
Tournament Schedule – Provides the date, time, location, and other event details for every matchup taking place in a given tournament.
Tournament Summary – Provides tournament information including location, status, start date, end date, and participants.
Weekly Depth Charts – Provides depth chart information for each team for a given week.
Weekly Injuries – Provides a list of injured players for each team for a given week.
Weekly Schedule – Provides complete schedule information for a given week of the season, including venue, weather conditions, broadcast info, and scoring results by quarter.
Push Events – Provides detailed, real-time information on every live game event.
Push Statistics - Provides detailed, real-time game stats at the team and player level for all live games.
Data Retrieval Sample
To find a teams number of defensive sacks:
- Call the season or weekly schedule and find the desired Team Id
- Call the Seasonal Statistics using the Team Id
- Locate the Team Defense Sacks.
The teams number of defensive sacks is displayed.
Key Updates and UFL Rules
Our UFL API features the same architecture, endpoints, and attributes as our NFL and NCAA Football offerings, allowing for a smooth integration. However, there are a handful of unique UFL rules that will differentiate this product. Note that these are very similar to the USFL API.
Please reference this section for rule information and samples to aid your development.
UFL Rule Updates
- Kickoffs will be from the 25-yard line.
- All touchbacks will come back to the 25-yard line.
- Each coach will get only one challenge.
- A team may attempt a 4th and 12 play from their 28-yard line as an alternative to a kickoff or an onside kick attempt. If successful in making a first down, they will keep the ball.
- Point after attempts will all be scrimmage plays. Teams will receive 1 point for a scrimmage play snapped from the 2-yard line, 2 points for a scrimmage play snapped from the 5-yard line, and 3 points for a scrimmage play snapped from the 10-yard line.
- During a point after attempt, if the defense gains possession and tries to score, they will receive points based on the conversion attempt. So, for example, a 1-point attempt return will score 1 point for the defense.
- Overtime will be a best-of-three play shootout, with teams running alternating 2-point conversion plays from the 2-yard line. If the score is still tied after three plays, subsequent plays will be sudden death until there is a winner.
UFL Data Samples
Conversion Samples
- 1-Point Attempt Fail & Defensive Conversion (xml)
- 1-Point Attempt Fail & Defensive Conversion (json)
- 1-Point Attempt Success (xml)
- 1-Point Attempt Success (json)
- 3-Point Attempt Fail & Defensive Conversion (xml)
- 3-Point Attempt Fail & Defensive Conversion (json)
- Play-by-Play with Conversions (xml)
- Play-by-Play with Conversions (json)
- Game Statistics with Conversions (xml)
- Game Statistics with Conversions (json)
- Season Statistics with Conversions (xml)
- Season Statistics with Conversions (json)
Alternative Kickoff Samples
Overtime Shootout Play-by-Play Sample
Integration Links
Postman Workspace
Our entire Media APIs are available on Postman. Click the link above to be taken directly to our UFL API collection.
Feel free to follow and/or fork any collections to receive updates.
Schema Download
Open the zip file below to access our entire UFL API XSD schema.
Simulations
Click here for a detailed breakdown on our available simulations.