Stats

User directory with per-user rollups

Admin-only paginated list of users, each enriched with their active account-membership count, the sites reachable through those accounts, their highest plan tier, and the time of their last platform activity. Filterable by name/email search, platform role and email-verification state; sortable by sign-up time, last activity or name.

get/stats/users

Request

  • Base URL: https://api.nippy.host
  • URL: https://api.nippy.host/stats/users
  • Auth: bearer (a scheme the document does not define)

Query parameters

searchstring

Case-insensitive substring match against name or email. SQL wildcards in the input are treated literally.

role'user' | 'admin'

Restrict to a single platform role.

verifiedboolean

Restrict by email-verification state.

risk'high' | 'medium' | 'low' | 'flagged'

Restrict by advisory risk level (ADR 0049). flagged means high or medium. Users in a cluster reviewed as not a problem never match.

billing'paid' | 'trialing' | 'past_due' | 'canceling'

Restrict to users who own an account with a paid subscription in this state. paid means active, trialing or past due; canceling means cancelled with access until the period ends.

bannedboolean

Restrict by ban state.

sort'created' | 'lastActive' | 'name' | 'risk'

Sort column: sign-up time, last platform activity (users with no activity sort last), name, or risk score (unflagged users last).

sortDir'asc' | 'desc'

Sort direction.

pagenumber

1-based page number.

pageSizenumber

Rows per page.

Response

pagenumber required
pageSizenumber required
totalnumber required
totalPagesnumber required

Changes

No recorded changes to this operation across all 1 revision of this API.