List teams

Each data.items[] entry has the same team-field schema as GET /v1/{league}/teams/{id}. This endpoint discovers team IDs and returns a directory; the detail endpoint fetches one known ID. Neither automatically adds roster, schedule, or season-stat blocks. Use the separate team endpoints for those datasets. The directory is limited by limit (default/max 500), has no cursor, and returns an empty items array when no teams match. Per-field provenance is available on the single-team read, not on each directory item.

Returns { "data": { "items": [...] } }. For soccer, league membership is derived from all stored fixtures before joining the shared club and national-team directories. This avoids leaking teams from unrelated competitions that share the same canonical store.

Requires the odds entitlement (a paid plan). See Responses & Errors for the success envelope and availability rules.

GEThttps://api.sportquanta.com/v1/{league}/teamsTry it

GETList teams in a league

GEThttps://api.sportquanta.comhttps://api-stage.sportquanta.comhttp://localhost:8082/v1/{league}/teams

Send

List teams in a league

Expand optional fieldsCollapse optional fields

Each data.items[] entry has the same team-field schema as GET /v1/{league}/teams/{id}. This endpoint discovers team IDs and returns a directory; the detail endpoint fetches one known ID. Neither automatically adds roster, schedule, or season-stat blocks. Use the separate team endpoints for those datasets. The directory is limited by limit (default/max 500), has no cursor, and returns an empty items array when no teams match. Per-field provenance is available on the single-team read, not on each directory item.

Returns { "data": { "items": [...] } }. For soccer, league membership is derived from all stored fixtures before joining the shared club and national-team directories. This avoids leaking teams from unrelated competitions that share the same canonical store.

Requires the odds entitlement (a paid plan). See Responses & Errors for the success envelope and availability rules.

Authorization

Authorizationstringheaderrequired

Send a workspace API token in the Authorization: Bearer <token> header.

Bearer

Path

Query

limitinteger

List teams in a leaguecURL

200Example

Reference context: WKBL.

Overview · Response conventions

List teams in a league

curl --request GET \
  --url 'https://api.sportquanta.com/v1/wkbl/teams' \
  --header 'Authorization: Bearer <token>'

200 · Example

{
  "data": {
    "items": [
      {
        "id": "TEAM_ID",
        "canonical_id": "TEAM_ID",
        "name": "Example Team",
        "full_name": "Example City Team",
        "abbreviation": "EXM",
        "active": true,
        "logo_url": "https://assets.example.com/team-logo.png"
      }
    ]
  },
  "_meta": {
    "request_id": "REQUEST_ID",
    "served_from": "live",
    "cache_ttl_seconds": 300
  }
}

Authorizations

Authorizationstringheaderrequired

Send a workspace API token in the Authorization: Bearer <token> header.

Path Parameters

leagueenum<string>default:wkblrequired

League for this reference section: wkbl.

Available options: wkbl

Query Parameters

limitintegerdefault:500

Required range: 1 <= x, x <= 500

Response

200401403404422429500502503application/json

Team directory under data.items.

dataobjectrequired

data.itemsobject[]required

data.items.idstring

Opaque team identifier. Reuse the returned ID in team paths; do not construct one from a name or abbreviation.

data.items.canonical_idstring

Canonical identity for this team, when exposed. Can match id; it is not an upstream provider ID.

data.items.external_idsobject

Map from the exact stored source/namespace key to that provider's identifier for this entity. Keys vary by entity and league. Values are strings, even when the provider ID looks numeric. Use the exact key and value for external-ID lookups; these are distinct from the canonical ID. SOURCE_KEY below is an illustrative placeholder.

data.items.external_ids.{key}string

data.items.created_atstring<date-time>

Canonical document creation timestamp, when present; not the scheduled start or event time.

data.items.updated_atstring<date-time>

Canonical document update timestamp, when present. It is not a guarantee that every field was refreshed at this time; field provenance carries individual ingestion times.

data.items.abbreviationstring

Short team code supplied by the source. Use id for lookups; abbreviations are display labels.

data.items.namestring

Source-supplied base team name. It may be a nickname or common label rather than the full display name.

data.items.team_namestring

Team-name component supplied by the source, when available. May overlap with name or full_name.

data.items.full_namestring

Full team display name supplied by the source, when available.

data.items.short_namestring

Short display label supplied by the source, when available; not necessarily the abbreviation.

data.items.korean_namestring

Korean short/common team name, when supplied by this projection.

data.items.korean_full_namestring

Korean full team name, when supplied by this projection.

data.items.logo_asset_keystring

Stored asset key, when available. Prefer the materialized URL field for display instead of constructing a storage URL.

data.items.official_logo_urlstring

Stored official/provider logo URL, when available. May differ from the materialized logo_url; source and league determine availability.

data.items.activeboolean

Source-supplied active flag. Omission means the flag is unavailable; it must not be treated as false.

data.items.logo_urlstring

Materialized logo URL for display, when resolvable. Omitted when no usable logo is available; use a UI fallback.

_metaobject

Response request/cache metadata. Optional evidence fields are specific to this handler; cache TTL does not measure source-data freshness.

_meta.request_idstring

_meta.served_fromenum<string>

Available options: live, cache

_meta.cache_ttl_secondsinteger

Response cache TTL; independent of source freshness. Omitted when zero.