Sign in
users

Get a list of users

Changed on

Returns a list of users based on search criteria.

get/users.json

Request

  • Base URL: https://e621.net
  • URL: https://e621.net/users.json
  • Auth: one of:
    • none
    • HTTP basic
    • API key in query parameter login and API key in query parameter api_key

Query parameters

pageinteger

The page number to retrieve

limitinteger

The number of users to retrieve per page

search[id]string

Filter by user ID

search[name]string

Filter by username

search[about]string

Filter by user's "About" section

search[avatar_id]integer

Filter by avatar ID

search[level]integer

Filter by user's access level

search[min_level]integer

Filter by minimum access level

search[max_level]integer

Filter by maximum access level

search[can_upload_free]boolean

Filter by upload permissions

search[can_approve_posts]boolean

Filter by post approval permissions

search[order]'date' | 'name' | 'post_upload_count' | 'note_count' | 'post_update_count'

Order the results by a specific field

Response

A list of users matching the search criteria

idinteger required

The unique ID of the user

created_atstring date-time required

The timestamp when the user account was created

namestring required

The username of the user

levelinteger required

The user's access level (numerical)

base_upload_limitinteger required

The base upload limit for the user

upload_karmainteger required

The user's upload karma

upload_karma_freeboolean required

Whether the user is exempt from the upload karma system

post_upload_countinteger required

Number of posts uploaded by the user

post_update_countinteger required

Number of post updates made by the user

note_update_countinteger required

Number of note updates made by the user

is_bannedboolean required

Whether the user is banned

can_approve_postsboolean required

Whether the user can approve posts

can_upload_freeboolean required

Whether the user can upload without restrictions

level_stringstring required

The user's access level (textual description)

avatar_idinteger

The ID of the user's avatar image

is_verifiedboolean

Whether the user has verified their email

has_cropped_avatarboolean

Whether the user has a server-side cropped avatar

Changes

  • 7eb984be63caRevision changes
    • ○

      added the required property / to the response with the status

    • ○

      added the required property / to the response with the status

  • 1004727c4111Revision changes
    • ○

      added the optional property / to the response with the status