The Blue Alliance API v3

thebluealliance · Data

Data No Auth Free & Open open_data

# Overview Information and statistics about FIRST Robotics Competition teams and events. # Authentication All endpoints require an Auth Key to be passed in the header `X-TBA-Auth-Key`. If you do not have an auth key yet, you can obtain one from your [Account Page](/account).

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET getStatus

Returns API status, and TBA status information.

https://api.apis.guru/v2/specs/thebluealliance.com/3.8.2/status

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/thebluealliance.com/3.8.2/status"

import requests
response = requests.get(
    "https://api.apis.guru/v2/specs/thebluealliance.com/3.8.2/status",
)
print(response.json())

const url = 'https://api.apis.guru/v2/specs/thebluealliance.com/3.8.2/status';

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	targetURL := "https://api.apis.guru/v2/specs/thebluealliance.com/3.8.2/status"
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/thebluealliance.com/3.8.2/status")

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/thebluealliance.com/3.8.2/status";
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET getDistrictsByYear

Gets a list of districts and their corresponding district key, for the given year.

https://api.apis.guru/v2/specs/thebluealliance.com/3.8.2/districts/{year}

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/thebluealliance.com/3.8.2/districts/{year}"

import requests
response = requests.get(
    "https://api.apis.guru/v2/specs/thebluealliance.com/3.8.2/districts/{year}",
)
print(response.json())

const url = 'https://api.apis.guru/v2/specs/thebluealliance.com/3.8.2/districts/{year}';

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	targetURL := "https://api.apis.guru/v2/specs/thebluealliance.com/3.8.2/districts/{year}"
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/thebluealliance.com/3.8.2/districts/{year}")

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/thebluealliance.com/3.8.2/districts/{year}";
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET getEvent

Gets an Event.

https://api.apis.guru/v2/specs/thebluealliance.com/3.8.2/event/{event_key}

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/thebluealliance.com/3.8.2/event/{event_key}"

import requests
response = requests.get(
    "https://api.apis.guru/v2/specs/thebluealliance.com/3.8.2/event/{event_key}",
)
print(response.json())

const url = 'https://api.apis.guru/v2/specs/thebluealliance.com/3.8.2/event/{event_key}';

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	targetURL := "https://api.apis.guru/v2/specs/thebluealliance.com/3.8.2/event/{event_key}"
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/thebluealliance.com/3.8.2/event/{event_key}")

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/thebluealliance.com/3.8.2/event/{event_key}";
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗

See official documentation for authentication and setup.

What can you build with The Blue Alliance API v3?

The Blue Alliance API v3 is a Data API. Developers commonly use data APIs for:

enriching your app with third-party datasets
building data pipelines and ETL workflows
querying and searching large datasets
powering research, analysis, and reporting tools
syncing reference data into your own systems

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. The Blue Alliance API v3 is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide · Learn about API keys · What is REST?

Open documentation ↗