# Sports Scores by League and Date

> Sports Scores by League and Date is a paid API for AI agents from payai.agentstools.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns game scores, statuses, venues, and metadata for MLB, NHL, NFL, NBA, or EPL games on a given date

## Facts

- Endpoint: GET https://payai.agentstools.dev/sports/scores
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sports-scores-by-league-and-date-89dfac87
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8a3qkW8wXV2q7tx-3OwV7

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 sports-scores-by-league-and-date-89dfac87
```

Example prompt: What were the final MLB scores from yesterday, October 1st 2025? Show me up to 10 games.

## When to prefer this

Use this endpoint when you need structured, queryable sports score data across major leagues (MLB, NHL, NFL, NBA, EPL) for a specific date or current live games. Prefer this over scraping sports news sites when you need machine-readable scores with metadata like venues and game status in one call.

## Known failure modes

- Invalid or unsupported league key returns a validation error
- Malformed date format causes a bad request error
- No games found for the requested date returns an empty result set
- Limit out of range (below 1 or above 100) returns a validation error
- Future dates with no scheduled games may return empty results

## How this service works

Live and recent game scores for a major sports league, normalized to one cited JSON. Give a league such as mlb, nhl, nfl, nba or epl and get each game with both teams, the score, the game state, the period or inning and the start time. Sourced from official league APIs and ESPN, each record tagged with its source.

## Output

A list of game records for the requested league and date, each including the final or current score, game status (live/final/scheduled), team names, venue details, and data source attribution. Returns up to 50 results by default or up to the specified limit.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "league"
     ],
     "properties": {
      "date": {
       "type": "string",
       "description": "Optional day filter as an ISO date such as 2025-10-01. Omit for live and current games."
      },
      "limit": {
       "type": "integer",
       "maximum": 100,
       "minimum": 1,
       "description": "Max records to return, default 50"
      },
      "league": {
       "enum": [
        "mlb",
        "nhl",
        "nfl",
        "nba",
        "epl"
       ],
       "type": "string",
       "description": "League key. One of the supported major leagues."
      }
     }
    }
   },
   "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/sports-scores-by-league-and-date-89dfac87/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from payai.agentstools.dev](https://www.zero.xyz/host/payai.agentstools.dev/llms.txt)