---
title: "List Learning Users"
method: GET
path: "/learnings/users"
tags: ["Learnings"]
---

# List Learning Users

`GET /learnings/users`

List the users that own learning records, with a per-user count and last-updated timestamp. Intended as the entry point for a per-user view: list users here, then drill into a single user's learnings via `GET /learnings?user_id=...`. Records with no owner (`user_id IS NULL`) are excluded. Pass `learning_type` to restrict the grouping to a single store (e.g. `user_profile` or `user_memory`). For a scoped (non-admin) caller results are bound to that user; an explicit `user_id` that differs is rejected with 403. Admins and unscoped callers list all users. Sortable by `user_id` or `last_learning_updated_at` (the default).

## Query parameters

- `learning_type` string, nullable — Restrict the grouping to a single learning type
- `user_id` string, nullable — Restrict the result to a single user
- `limit` integer — Page size
- `page` integer — 1-indexed page number
- `sort_by` string, nullable — Field to sort by: user_id or last_learning_updated_at (the default)
- `sort_order` 'asc' | 'desc'
- `db_id` string, nullable — Database ID to query
- `table` string, nullable — The database table to use (requires db_id)

## Response `200`

Successful Response

- PaginatedResponseLearningUserStats
  - `data` LearningUserStats[], required — List of items for the current page
    - `user_id` string, required — The user ID
    - `last_learning_updated_at` integer, nullable — Most recent learning update for this user (Unix epoch seconds)
  - `meta` PaginationInfo, required
    - `page` integer — Current page number (0-indexed)
    - `limit` integer — Number of items per page
    - `total_pages` integer — Total number of pages
    - `total_count` integer — Total count of items
    - `search_time_ms` number — Search execution time in milliseconds

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/agno/apis/agno-api-reference.md) · [All operations](https://skmtc.net/agno/apis/agno-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/agno/agno-api-reference/revisions/5f6149d395d0/schema)