Shared content
GET
https://ba.joexyz.online/api/v1/rosters/:gameServer/:friendCodehttp://localhost:3000/api/v1/rosters/:gameServer/:friendCodeGets a public roster by the account's game server and friend code.
Parameters
gameServer(path):JP,KR,TW,NA,Asia,EUorCN.friendCode(path): The 8-letter friend code.
Authentication
No authentication required.
Path parameters
| Name | Value |
|---|---|
| gameServer | NA |
| friendCode | ABCDEFGH |
curl https://ba.joexyz.online/api/v1/rosters/NA/ABCDEFGHconst response = await fetch("https://ba.joexyz.online/api/v1/rosters/NA/ABCDEFGH");
const data = await response.json();
console.log(data);import requests
url = "https://ba.joexyz.online/api/v1/rosters/NA/ABCDEFGH"
response = requests.get(url)
print(response.json())package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://ba.joexyz.online/api/v1/rosters/NA/ABCDEFGH", nil)
if err != nil {
panic(err)
}
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
data, _ := io.ReadAll(res.Body)
fmt.Println(string(data))
}curl http://localhost:3000/api/v1/rosters/NA/ABCDEFGHconst response = await fetch("http://localhost:3000/api/v1/rosters/NA/ABCDEFGH");
const data = await response.json();
console.log(data);import requests
url = "http://localhost:3000/api/v1/rosters/NA/ABCDEFGH"
response = requests.get(url)
print(response.json())package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "http://localhost:3000/api/v1/rosters/NA/ABCDEFGH", nil)
if err != nil {
panic(err)
}
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
data, _ := io.ReadAll(res.Body)
fmt.Println(string(data))
}Response
{
"data": {
"id": "k17fp61xb5wqf8f6ge798sa1t17sg20f",
"createdAt": "2025-10-15T00:22:23.815Z",
"name": "Joe",
"accountLevel": 90,
"friendCode": "KQZRTVMW",
"gameServer": "EU",
"introduction": "Hello.\n\n**Note:** This isn't my full roster. Let me know if there's anyone in particular that you're looking for.",
"lastUpdated": 1783978245235,
"studentRepId": "kei",
"students": [
{
"studentId": "hoshino_battle_dealer",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 0,
"ex": 5,
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 74,
"starLevel": 5,
"sub": 10,
"ueLevel": 4
},
{
"studentId": "hoshino",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 2,
"ex": 5,
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 74,
"starLevel": 5,
"sub": 10,
"ueLevel": 4
},
{
"studentId": "hoshino_swimsuit",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 0,
"ex": 5,
"featuredBorrowSlot": "jfd",
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 64,
"starLevel": 5,
"sub": 10,
"ueLevel": 4
}
],
"visibility": "public"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "Roster not found."
}
}