REST APIAnalysis
`GET /v1/analysis/compare-teams?a=&b=&as_of=` — clubs OR national teams.
cost 10 unitspaid plan
Authorization
api_key X-API-Key<token>
In: header
Path Parameters
a*string
Team A (minted id). Required.
b*string
Team B (minted id). Required.
season*integer
Season year — roster of persons who appeared that season.
Format
int32as_of*|
RFC3339 instant — who represented the team in a window ending here.
Format
date-timeedition*string
Tournament edition id — appearances ∪ edition-overlapping memberships.
days*|
Look-back window in days for the Current/AsOf scopes (clamped [1, 90]).
Format
int32Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/analysis/compare-teams"{
"data": {
"a": {
"roster": [
{
"person": {
"bio": {
"birth_country": "BRA",
"display_name": "string",
"dob": "2019-08-24",
"full_name": "string",
"headshot_url": "string",
"height_inches": 0,
"position": "SF",
"weight_lbs": 0
},
"id": "per_0a1b2c3d4e5f6g7h8i9j0k1l2m"
},
"source": "appearance"
}
],
"team": {
"home_competition": "comp_0a1b2c3d4e5f6g7h8i9j0k1l2m",
"id": "team_0a1b2c3d4e5f6g7h8i9j0k1l2m",
"name": "string",
"sport": "basketball",
"traits": [
{
"country": "BRA",
"kind": "represents_country"
}
]
}
},
"b": {
"roster": [
{
"person": {
"bio": {
"birth_country": "BRA",
"display_name": "string",
"dob": "2019-08-24",
"full_name": "string",
"headshot_url": "string",
"height_inches": 0,
"position": "SF",
"weight_lbs": 0
},
"id": "per_0a1b2c3d4e5f6g7h8i9j0k1l2m"
},
"source": "appearance"
}
],
"team": {
"home_competition": "comp_0a1b2c3d4e5f6g7h8i9j0k1l2m",
"id": "team_0a1b2c3d4e5f6g7h8i9j0k1l2m",
"name": "string",
"sport": "basketball",
"traits": [
{
"country": "BRA",
"kind": "represents_country"
}
]
}
}
},
"meta": {
"cache": "HIT",
"fetched_at": "2025-10-15T18:30:00Z",
"request_id": "266ea41d-adf5-480b-af50-15b940c2b846",
"source": "postgres",
"version": "v1"
}
}{
"error": {
"code": "string",
"message": "string",
"property1": null,
"property2": null
}
}{
"error": {
"code": "string",
"message": "string",
"property1": null,
"property2": null
}
}