---
title: "Per-agent recap aggregates for the authenticated user"
method: GET
path: "/api/v1/me/recap"
tags: ["Me"]
---

# Per-agent recap aggregates for the authenticated user

`GET /api/v1/me/recap`

Returns per-agent aggregates (checkpoints, labels, skills, MCP servers, tool-profile mix) for the authenticated user's activity in the requested window. When ?repo=org/name is supplied, each agent row also carries a `contributors` counterpart aggregated across every contributor on the repo — what powers the 'you vs. team' columns in `entire recap`.

## Query parameters

- `timeframe` 'last-month' | 'last-3-months' | 'last-6-months'
- `repo` string
- `limit` integer
- `since` string, date-time
- `until` string, date-time

## Response `200`

Per-agent recap aggregates

- object
  - `timeframe` string, required
  - `repo` string, nullable, required
  - `repos` string[], required
  - `since` string, required
  - `until` string, required
  - `agents` object, required
  - `summary` object, required
    - `me` object, required
      - `sessions` number, required
      - `checkpoints` number, required
      - `tokens` number, required
    - `team` object, nullable, required
      - `sessions` number, required
      - `checkpoints` number, required
      - `tokens` number, required
    - `repoCount` number, required
    - `activeDays` number, required
    - `analysis` object, required
      - `complete` number, required
      - `pending` number, required
      - `failed` number, required
    - `transcripts` object, required
      - `me` object, required
        - `failed` integer, required
        - `pending` integer, required
        - `empty` integer, required
      - `team` object, nullable, required
        - `failed` integer, required
        - `pending` integer, required
        - `empty` integer, required
  - `contributors` object, nullable, required
    - `distinctUsers` number, required
    - `totalTokens` number, required
    - `totalCheckpoints` number, required
  - `daily` object[], required
    - `date` string, required
    - `count` number, required
  - `updated_at` string, required

## Other responses

- `400` — Invalid since/until (must be supplied together as ISO-8601, with since < until)
- `401` — Not authenticated
- `404` — Authenticated user record not found
- `500` — Failed to build recap

---

[API](https://skmtc.dev/entire/apis/entire-api.md) · [All operations](https://skmtc.dev/entire/apis/entire-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/entire/entire-api/revisions/c3d737ae064e/schema)