# TheSportsDB All Leagues Lookup

> TheSportsDB All Leagues Lookup is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.07/call, status unknown (last checked 2026-09-14).

Returns a full list of all sports leagues from TheSportsDB, including league ID, name, and sport type, with no API key required.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/suverse-sports-leagues
- Price: $0.07/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/thesportsdb-all-leagues-lookup-ff7f20e9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IqpxwYJcJXpszCPcp9rM8

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability thesportsdb-all-leagues-lookup-ff7f20e9 -d '<json body>'
```

Example prompt: Can you pull the full list of sports leagues from TheSportsDB so I can find the league ID for the Bundesliga?

## When to prefer this

Use this endpoint when you need to enumerate all leagues and resolve league names to their TheSportsDB numeric IDs without requiring an API key. It is the right choice when building sports data pipelines that depend on league IDs for downstream queries, or when constructing navigation structures across multiple sports. Prefer this over direct TheSportsDB API calls when you want a managed, key-free proxy with x402 micropayment access.

## Known failure modes

- TheSportsDB upstream unavailable — proxy returns 5xx or empty response
- Payment not processed correctly via x402 — endpoint returns 402 Payment Required
- No response body if POST body is malformed or content-type is incorrect
- Rate limiting or quota exhaustion on the upstream TheSportsDB API

## How this service works

The list of all leagues from TheSportsDB, no key. Returns league id, name, and sport. For AI agents resolving league ids and building sports navigation.

## Output

A JSON array of all sports leagues in TheSportsDB, each entry containing the league's numeric ID (idLeague), league name (strLeague), and sport type (strSport). Example entries include soccer leagues like English Premier League (ID 4328) and German Bundesliga (ID 4331).

## Example request

```json
{
 "sport": "basketball",
 "league": "NBA",
 "season": 2024
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/thesportsdb-all-leagues-lookup-ff7f20e9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)