Sign in
staff

Get a list of staff files

Changed on

Returns a list of staff-uploaded files matching the search criteria. Requires staff-level access.

get/staff/files.json

Request

  • Base URL: https://e621.net
  • URL: https://e621.net/staff/files.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 staff files to retrieve per page

search[id]string

Filter by staff file ID

search[created_at]string

Filter by the creation date of the staff file

search[updated_at]string

Filter by the last update date of the staff file

search[creator_id]integer

Filter by the ID of the user who uploaded the file

search[creator_name]string

Filter by the username of the user who uploaded the file

search[original_filename]string

Filter by the original filename, case-insensitively

search[file_ext]string

Filter by the file extension

search[order]'original_filename' | 'time' | 'id_asc' | 'id_desc'

Order the results by a specific field

Response

A list of staff files

idinteger required

The unique ID of the staff file

creator_idinteger required

The ID of the user who uploaded the file

storage_idstring required

The random identifier the file is stored under

md5string required

The MD5 hash of the file contents

file_extstring required

The file extension, lowercased, with jpeg normalized to jpg

file_sizeinteger required

The size of the file in bytes

original_filenamestring required

The filename the file was uploaded under

titlestring nullable

The display title, defaulting to the original filename

descriptionstring nullable

A free-text description of the file

created_atstring date-time required

When the file was uploaded

updated_atstring date-time required

When the file record was last updated

Changes