Skip to content

Game data

List students

GET
https://ba.joexyz.online/api/v1/students

Lists playable students in the default roster order. With q, every student matching the other filters is ranked by a fuzzy match on the name and search tags, best first, and each result gets a matchScore.

Filters take the values used in responses, for example school=Abydos or combatRole=Tanker.

Parameters

  • q: Fuzzy search on the name and search tags.
  • school: Abydos, Arius, Gehenna, Hyakkiyako, Millennium, RedWinter, Shanhaijing, SRT, Trinity, Valkyrie, Highlander, WildHunt, Odyssey, Tokiwadai, Sakugawa or ETC.
  • club: Club, e.g. Countermeasure.
  • attackType: Explosion, Pierce, Mystic, Sonic, Chemical, Normal or Mixed, or a color: red (Explosion), yellow (Pierce), blue (Mystic), purple (Sonic) or green (Chemical).
  • defenseType: LightArmor, HeavyArmor, Unarmed, ElasticArmor, CompositeArmor, Normal or Mixed, or a color: red (LightArmor), yellow (HeavyArmor), blue (Unarmed), purple (ElasticArmor) or green (CompositeArmor).
  • combatClass: Main (striker) or Support (special).
  • combatRole: DamageDealer, Tanker, Healer, Supporter or Vehicle.
  • weaponType: SR, SG, AR, MG, SMG, RG, HG, GL, RL, FT or MT.
  • rarity: Initial star rarity, 1–3.
  • limit: Maximum number of results, 1–500. Defaults to 500.

Authentication

No authentication required.

Query parameters

NameValue
qhoshino
school
club
attackType
defenseType
combatClass
combatRole
weaponType
rarity
limit
curl 'https://ba.joexyz.online/api/v1/students?q=hoshino&school=&club=&attackType=&defenseType=&combatClass=&combatRole=&weaponType=&rarity=&limit='
Response
{
  "data": [
    {
      "id": "hoshino",
      "name": "Hoshino",
      "devName": "Hoshino",
      "school": "Abydos",
      "club": "Countermeasure",
      "combatClass": "Main",
      "combatRole": "Tanker",
      "combatPosition": "Front",
      "attackType": "Pierce",
      "defenseType": "HeavyArmor",
      "weaponType": "SG",
      "rarity": 3,
      "searchTags": [
        "ホシノ",
        "おじさん",
        "호시노",
        "星野"
      ],
      "iconUrl": "https://ba.cdn.nimblebun.works/v2/images/students/icons/hoshino.png",
      "portraitUrl": "https://ba.cdn.nimblebun.works/v2/images/students/portraits/hoshino.png",
      "matchScore": 0.989901
    }
  ]
}

Joe's Blue Archive Tools API · exported Nov 1, 2026

llms.txtBuilt with yaakdoc