---
title: "Today's catalog with the caller's played-today state"
method: GET
path: "/api/v1/engage/games/today"
tags: ["Games", "Game Engine", "Engage"]
---

# Today's catalog with the caller's played-today state

`GET /api/v1/engage/games/today`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/v1/engage/games/today`
- Auth: HTTP bearer

Same rows as /api/v1/engage/games/catalog plus per-game daily-slot state for the caller: todayStatus UNPLAYED | IN_PROGRESS | PLAYED, sessionId/sessionStatus/attemptsUsed/attemptsRemaining (null without a session), and top-level dayKey/resetsAt (next UTC midnight). locker-singularity derives PLAYED from IdleLedger.lastSeenAt — it has no engine session.

## Query parameters

- `teamId` string
- `teamSlug` string

## Headers

- `X-Client-Version` string

## Response `200`

{ dayKey, resetsAt, daily, weekly } EngineTodayGame[] with todayStatus + session fields

## Other responses

- `401`: Authentication required
- `404`: Team not found
- `500`: Internal error

## Changes

- **2026-11-18** `6de639c52609`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/v1/engage/games/today/get.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
