Ya its totally fine. You can keep using /admin/users.json
. It uses the exact same underlying code as as /admin/users/list/{flag}.json
. That’s probably one of the reasons it hasn’t been documented yet.
I’m able to get /admin/users.json
to return a brand new user without any topics.
curl -i -sSL -X GET "http://localhost:4200/admin/users.json?email=982f145c7@example.com" \
-H "Api-Key: ..." \
-H "Api-Username: blake"
HTTP/1.1 200 OK
[
{
"id": 2731,
"username": "982f145c7",
"name": "982f145c7",
"avatar_template": "/letter_avatar_proxy/v4/letter/9/46a35a/{size}.png",
"active": true,
"admin": false,
"moderator": false,
"last_seen_at": null,
"last_emailed_at": null,
"created_at": "2025-04-29T12:31:52.894Z",
"last_seen_age": null,
"last_emailed_age": null,
"created_at_age": 103.259451,
"trust_level": 1,
"manual_locked_trust_level": null,
"title": null,
"time_read": 0,
"staged": false,
"can_be_deleted": true,
"silence_reason": "",
"days_visited": 0,
"posts_read_count": 0,
"topics_entered": 0,
"post_count": 0
}
]
You do need to make sure you use the exact email address or you will get an empty array as a result.