{"uid":"cap_8a3qkW8wXV2q7tx-3OwV7","slug":"sports-scores-by-league-and-date-89dfac87","name":"Sports Scores by League and Date","description":"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.","url":"https://payai.agentstools.dev/sports/scores","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VTBXDVMPRCNnSl9gHQl5b","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns game scores, statuses, venues, and metadata for MLB, NHL, NFL, NBA, or EPL games on a given date","exampleAgentPrompt":"What were the final MLB scores from yesterday, October 1st 2025? Show me up to 10 games.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T08:20:17.332Z","isFirstParty":false}