FRC Division Notifier API

An API to retrieve information reguarding the status of division assignments for the 2016 FIRST© Robotics Competition World Championship. This will eliminate the need for many people to scrape FIRST's website, since this information is not provided in the official FRC API.

Recommended minimum polling interval is 1 minute due to server side caching, although 5 minutes or longer should be sufficient for most use cases.

No authentication is currently required, however if unmanageable high volume occurs an API key will be required for continued use and rate limits may be enforced.

FIRST and FIRST Robotics Competition are registered trademarks of FIRST (www.firstinspires.org) which is not overseeing, involved with, or responsible for this API.

I provide no guarantee for this product. Use it at your own risk.

Base path: http://frc.divisions.co/api/v1/
Contact Info: frc@evanforbes.net
Version: 1.0.0
All rights reserved

Methods

Up 
get /status
Gets the current status of the division release

URL

http://frc.divisions.co/api/v1/status

Return type

Status

Responses

200

Successful response

401

Unauthorized

500

Server error 
get /team_list
Gets the current list of teams registered for the FRC World Championship

URL

http://frc.divisions.co/api/v1/team_list

Return type

[Team]

Responses

200

Successful response

401

Unauthorized

500

Server error

Models

Team

team_number
Integer
team_name
String AKA nickname
location
String City, State, Country
division_name
String The division this team has been assigned to, or null if it has not yet been assigned
Enum:
Archimedes
Carson
Carver
Curie
Galileo
Hopper
Newton
Tesla

Status

out
Boolean true when at least one team has been assigned to a division, otherwise false
state
String The current state of the division release
Enum:
none
some
all
description
String The current state of the division release, in human-friendly text
Enum:
Divisions are out
Divisions are out for some teams
Divisions are not out
team_count
Integer Total number of teams on the registration list for the championship
team_count_with_divisions
Integer Total number of teams on the registration list for the championship that have been assigned to a division
motd
String A useless message