Sport catalog

GEThttps://www.preciseev.com/api/sports/catalog

Games, available dates and supported markets for one sport and date.

Research planNeeds a signed-in account on Basic or Premium (the research feature).

Description

Use the catalog first: it returns the game IDs and market keys the research board expects.

Only games ESPN lists for that date are returned. availableDates shows nearby dates that have games.

Query parameters

sportstringrequired

The league to read.

datestring · date

Slate date, YYYY-MM-DD. Defaults to today (America/Phoenix).

marketstring

Stat market, e.g. points, rebounds, assists, threes (NBA/WNBA), shots, goals, saves (NHL/soccer). Defaults to the sport's first market.

leaguestring

Soccer only. Defaults to eng.1.

Allowed: eng.1 esp.1 ger.1 ita.1 fra.1 usa.1 uefa.champions

gamestring

An event ID (6–12 digits).

Responses

Language

Credentials

SessionYour PreciseEV sign-inAPI keys soon

cURL request

curl --request GET \
     --url 'https://www.preciseev.com/api/sports/catalog?sport=nba&market=points' \
     --header 'accept: application/json'

Sends from your browser with your session.

Response

Click Try it! to send a request and see the response here, or choose an example:

{
  "sport": "nba",
  "league": null,
  "date": "2026-10-21",
  "games": [
    {
      "id": "401704871",
      "date": "2026-10-21",
      "startTime": "2026-10-21T23:30Z",
      "home": {
        "id": "2",
        "name": "Boston Celtics",
        "code": "BOS",
        "score": null
      },
      "away": {
        "id": "18",
        "name": "New York Knicks",
        "code": "NY",
        "score": null
      },
      "venue": "TD Garden",
      "state": "pre",
      "complete": false,
      "status": "Scheduled",
      "season": 2027,
      "seasonType": 2
    }
  ],
  "availableDates": [
    "2026-10-21",
    "2026-10-22"
  ],
  "source": {
    "url": "https://site.api.espn.com/…",
    "fetchedAt": "2026-10-21T15:02:11Z",
    "stale": false,
    "error": null
  },
  "markets": {
    "points": {
      "label": "Points",
      "fields": [
        "PTS"
      ],
      "benchmark": "season"
    }
  }
}

200 · The catalog. Example values.