Your data / PVP tracker / Matches
POST
https://ba.joexyz.online/api/v1/me/pvp/seasons/:seasonId/matcheshttp://localhost:3000/api/v1/me/pvp/seasons/:seasonId/matchesRecords a match. matchType is attack or defense; result is win
or loss. Link the opponent with enemyPresetId, or set
autoCreateEnemyPreset to create a preset from opponentName.
includeInStatistics uses your preference when left out.
Parameters
seasonId(path): The season id.
Authentication
Bearer Token — send Authorization: Bearer <token>. Inherited from folder "Your data".
Path parameters
| Name | Value |
|---|---|
| seasonId |
Headers
| Name | Value |
|---|---|
| Content-Type | application/json |
Bodyapplication/json
{
"date": 1789074000000,
"matchType": "attack",
"result": "win",
"opponentName": "Hinanbu",
"opponentStudentRepId": "misaka_mikoto",
"enemyPresetId": "md7bhbqc3pdtptx2w6xkj2kv3d8e2pcz",
"ownTeam": [
{
"studentId": "shiroko_terror",
"damage": 1513971
},
{
"studentId": "yuuka",
"damage": 110235
},
{
"studentId": "mika",
"damage": 334593
},
{
"studentId": "eimi",
"damage": 224859
},
{
"studentId": "reisa_magical",
"damage": 5599
},
{
"studentId": "utaha",
"damage": 327809
}
],
"opponentTeam": [
{
"studentId": "shun",
"damage": 584686
},
{
"studentId": "hoshino_battle_dealer",
"damage": 139014
},
{
"studentId": "marina",
"damage": 58185
},
{
"studentId": "shiroko_terror",
"damage": 1631926
},
{
"studentId": "hibiki",
"damage": 2059301
},
{
"studentId": "shiroko_swimsuit",
"damage": 0
}
]
}curl -X POST https://ba.joexyz.online/api/v1/me/pvp/seasons/:seasonId/matches \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer {{api_key}}' \
--data-raw '{
"date": 1789074000000,
"matchType": "attack",
"result": "win",
"opponentName": "Hinanbu",
"opponentStudentRepId": "misaka_mikoto",
"enemyPresetId": "md7bhbqc3pdtptx2w6xkj2kv3d8e2pcz",
"ownTeam": [
{
"studentId": "shiroko_terror",
"damage": 1513971
},
{
"studentId": "yuuka",
"damage": 110235
},
{
"studentId": "mika",
"damage": 334593
},
{
"studentId": "eimi",
"damage": 224859
},
{
"studentId": "reisa_magical",
"damage": 5599
},
{
"studentId": "utaha",
"damage": 327809
}
],
"opponentTeam": [
{
"studentId": "shun",
"damage": 584686
},
{
"studentId": "hoshino_battle_dealer",
"damage": 139014
},
{
"studentId": "marina",
"damage": 58185
},
{
"studentId": "shiroko_terror",
"damage": 1631926
},
{
"studentId": "hibiki",
"damage": 2059301
},
{
"studentId": "shiroko_swimsuit",
"damage": 0
}
]
}'const response = await fetch("https://ba.joexyz.online/api/v1/me/pvp/seasons/:seasonId/matches", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer {{api_key}}",
},
body: JSON.stringify({
"date": 1789074000000,
"matchType": "attack",
"result": "win",
"opponentName": "Hinanbu",
"opponentStudentRepId": "misaka_mikoto",
"enemyPresetId": "md7bhbqc3pdtptx2w6xkj2kv3d8e2pcz",
"ownTeam": [
{
"studentId": "shiroko_terror",
"damage": 1513971
},
{
"studentId": "yuuka",
"damage": 110235
},
{
"studentId": "mika",
"damage": 334593
},
{
"studentId": "eimi",
"damage": 224859
},
{
"studentId": "reisa_magical",
"damage": 5599
},
{
"studentId": "utaha",
"damage": 327809
}
],
"opponentTeam": [
{
"studentId": "shun",
"damage": 584686
},
{
"studentId": "hoshino_battle_dealer",
"damage": 139014
},
{
"studentId": "marina",
"damage": 58185
},
{
"studentId": "shiroko_terror",
"damage": 1631926
},
{
"studentId": "hibiki",
"damage": 2059301
},
{
"studentId": "shiroko_swimsuit",
"damage": 0
}
]
}),
});
const data = await response.json();
console.log(data);import requests
url = "https://ba.joexyz.online/api/v1/me/pvp/seasons/:seasonId/matches"
headers = {
"Authorization": "Bearer {{api_key}}",
}
payload = {
"date": 1789074000000,
"matchType": "attack",
"result": "win",
"opponentName": "Hinanbu",
"opponentStudentRepId": "misaka_mikoto",
"enemyPresetId": "md7bhbqc3pdtptx2w6xkj2kv3d8e2pcz",
"ownTeam": [
{
"studentId": "shiroko_terror",
"damage": 1513971,
},
{
"studentId": "yuuka",
"damage": 110235,
},
{
"studentId": "mika",
"damage": 334593,
},
{
"studentId": "eimi",
"damage": 224859,
},
{
"studentId": "reisa_magical",
"damage": 5599,
},
{
"studentId": "utaha",
"damage": 327809,
},
],
"opponentTeam": [
{
"studentId": "shun",
"damage": 584686,
},
{
"studentId": "hoshino_battle_dealer",
"damage": 139014,
},
{
"studentId": "marina",
"damage": 58185,
},
{
"studentId": "shiroko_terror",
"damage": 1631926,
},
{
"studentId": "hibiki",
"damage": 2059301,
},
{
"studentId": "shiroko_swimsuit",
"damage": 0,
},
],
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())package main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
body := strings.NewReader(`{
"date": 1789074000000,
"matchType": "attack",
"result": "win",
"opponentName": "Hinanbu",
"opponentStudentRepId": "misaka_mikoto",
"enemyPresetId": "md7bhbqc3pdtptx2w6xkj2kv3d8e2pcz",
"ownTeam": [
{
"studentId": "shiroko_terror",
"damage": 1513971
},
{
"studentId": "yuuka",
"damage": 110235
},
{
"studentId": "mika",
"damage": 334593
},
{
"studentId": "eimi",
"damage": 224859
},
{
"studentId": "reisa_magical",
"damage": 5599
},
{
"studentId": "utaha",
"damage": 327809
}
],
"opponentTeam": [
{
"studentId": "shun",
"damage": 584686
},
{
"studentId": "hoshino_battle_dealer",
"damage": 139014
},
{
"studentId": "marina",
"damage": 58185
},
{
"studentId": "shiroko_terror",
"damage": 1631926
},
{
"studentId": "hibiki",
"damage": 2059301
},
{
"studentId": "shiroko_swimsuit",
"damage": 0
}
]
}`)
req, err := http.NewRequest("POST", "https://ba.joexyz.online/api/v1/me/pvp/seasons/:seasonId/matches", body)
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer {{api_key}}")
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 -X POST http://localhost:3000/api/v1/me/pvp/seasons/:seasonId/matches \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer {{api_key}}' \
--data-raw '{
"date": 1789074000000,
"matchType": "attack",
"result": "win",
"opponentName": "Hinanbu",
"opponentStudentRepId": "misaka_mikoto",
"enemyPresetId": "md7bhbqc3pdtptx2w6xkj2kv3d8e2pcz",
"ownTeam": [
{
"studentId": "shiroko_terror",
"damage": 1513971
},
{
"studentId": "yuuka",
"damage": 110235
},
{
"studentId": "mika",
"damage": 334593
},
{
"studentId": "eimi",
"damage": 224859
},
{
"studentId": "reisa_magical",
"damage": 5599
},
{
"studentId": "utaha",
"damage": 327809
}
],
"opponentTeam": [
{
"studentId": "shun",
"damage": 584686
},
{
"studentId": "hoshino_battle_dealer",
"damage": 139014
},
{
"studentId": "marina",
"damage": 58185
},
{
"studentId": "shiroko_terror",
"damage": 1631926
},
{
"studentId": "hibiki",
"damage": 2059301
},
{
"studentId": "shiroko_swimsuit",
"damage": 0
}
]
}'const response = await fetch("http://localhost:3000/api/v1/me/pvp/seasons/:seasonId/matches", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer {{api_key}}",
},
body: JSON.stringify({
"date": 1789074000000,
"matchType": "attack",
"result": "win",
"opponentName": "Hinanbu",
"opponentStudentRepId": "misaka_mikoto",
"enemyPresetId": "md7bhbqc3pdtptx2w6xkj2kv3d8e2pcz",
"ownTeam": [
{
"studentId": "shiroko_terror",
"damage": 1513971
},
{
"studentId": "yuuka",
"damage": 110235
},
{
"studentId": "mika",
"damage": 334593
},
{
"studentId": "eimi",
"damage": 224859
},
{
"studentId": "reisa_magical",
"damage": 5599
},
{
"studentId": "utaha",
"damage": 327809
}
],
"opponentTeam": [
{
"studentId": "shun",
"damage": 584686
},
{
"studentId": "hoshino_battle_dealer",
"damage": 139014
},
{
"studentId": "marina",
"damage": 58185
},
{
"studentId": "shiroko_terror",
"damage": 1631926
},
{
"studentId": "hibiki",
"damage": 2059301
},
{
"studentId": "shiroko_swimsuit",
"damage": 0
}
]
}),
});
const data = await response.json();
console.log(data);import requests
url = "http://localhost:3000/api/v1/me/pvp/seasons/:seasonId/matches"
headers = {
"Authorization": "Bearer {{api_key}}",
}
payload = {
"date": 1789074000000,
"matchType": "attack",
"result": "win",
"opponentName": "Hinanbu",
"opponentStudentRepId": "misaka_mikoto",
"enemyPresetId": "md7bhbqc3pdtptx2w6xkj2kv3d8e2pcz",
"ownTeam": [
{
"studentId": "shiroko_terror",
"damage": 1513971,
},
{
"studentId": "yuuka",
"damage": 110235,
},
{
"studentId": "mika",
"damage": 334593,
},
{
"studentId": "eimi",
"damage": 224859,
},
{
"studentId": "reisa_magical",
"damage": 5599,
},
{
"studentId": "utaha",
"damage": 327809,
},
],
"opponentTeam": [
{
"studentId": "shun",
"damage": 584686,
},
{
"studentId": "hoshino_battle_dealer",
"damage": 139014,
},
{
"studentId": "marina",
"damage": 58185,
},
{
"studentId": "shiroko_terror",
"damage": 1631926,
},
{
"studentId": "hibiki",
"damage": 2059301,
},
{
"studentId": "shiroko_swimsuit",
"damage": 0,
},
],
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())package main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
body := strings.NewReader(`{
"date": 1789074000000,
"matchType": "attack",
"result": "win",
"opponentName": "Hinanbu",
"opponentStudentRepId": "misaka_mikoto",
"enemyPresetId": "md7bhbqc3pdtptx2w6xkj2kv3d8e2pcz",
"ownTeam": [
{
"studentId": "shiroko_terror",
"damage": 1513971
},
{
"studentId": "yuuka",
"damage": 110235
},
{
"studentId": "mika",
"damage": 334593
},
{
"studentId": "eimi",
"damage": 224859
},
{
"studentId": "reisa_magical",
"damage": 5599
},
{
"studentId": "utaha",
"damage": 327809
}
],
"opponentTeam": [
{
"studentId": "shun",
"damage": 584686
},
{
"studentId": "hoshino_battle_dealer",
"damage": 139014
},
{
"studentId": "marina",
"damage": 58185
},
{
"studentId": "shiroko_terror",
"damage": 1631926
},
{
"studentId": "hibiki",
"damage": 2059301
},
{
"studentId": "shiroko_swimsuit",
"damage": 0
}
]
}`)
req, err := http.NewRequest("POST", "http://localhost:3000/api/v1/me/pvp/seasons/:seasonId/matches", body)
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer {{api_key}}")
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": "kd7c9s359tzb40zpp1xxr5m23d8e96ye",
"createdAt": "2026-09-12T18:25:20.987Z",
"date": 1789074000000,
"enemyPresetId": "md7bhbqc3pdtptx2w6xkj2kv3d8e2pcz",
"matchType": "attack",
"opponentName": "Hinanbu",
"opponentStudentRepId": "misaka_mikoto",
"opponentTeam": [
{
"studentId": "shun",
"damage": 584686
},
{
"studentId": "hoshino_battle_dealer",
"damage": 139014
},
{
"studentId": "marina",
"damage": 58185
},
{
"studentId": "shiroko_terror",
"damage": 1631926
},
{
"studentId": "hibiki",
"damage": 2059301
},
{
"studentId": "shiroko_swimsuit",
"damage": 0
}
],
"opponentTeamKey": "68a885102ce96189",
"ownTeam": [
{
"studentId": "shiroko_terror",
"damage": 1513971
},
{
"studentId": "yuuka",
"damage": 110235
},
{
"studentId": "mika",
"damage": 334593
},
{
"studentId": "eimi",
"damage": 224859
},
{
"studentId": "reisa_magical",
"damage": 5599
},
{
"studentId": "utaha",
"damage": 327809
}
],
"ownTeamKey": "87c5db1146f598f0",
"result": "win",
"seasonId": "kh73y62jqqhmwbxbnrtpdfe7w18dydwx"
}
}