Sign in
post_flags

Get a list of post flags

Changed on

Returns a list of post flags based on search criteria.

get/post_flags.json

Request

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

search[reason_matches]string

Filter post flags by matching reason text

search[post_tags_match]string

Filter post flags by matching post tags

search[post_id]integer

Filter post flags by post ID

search[type]'flag' | 'deletion'

The type of the flag (e.g., flag or deletion)

Filter post flags by type (e.g., flag or deletion)

search[is_resolved]boolean

Filter post flags by resolution status

search[creator_name]string

Filter post flags by the creator's username

search[creator_id]integer

Filter post flags by creator ID

search[created_at]string

Filter post flags by creation date

search[updated_at]string

Filter post flags by last update date

search[id]string

Filter post flags by flag ID

Response

A list of post flags matching the search criteria

idinteger required

The unique ID of the post flag

created_atstring date-time required

The timestamp when the post flag was created

post_idinteger required

The ID of the post that the flag is related to

reasonstring required

The reason for the flag or deletion request

creator_idinteger

The ID of the user who created the flag or deletion request

is_resolvedboolean required

Whether the flag has been resolved

updated_atstring date-time required

The timestamp when the post flag was last updated

is_deletionboolean required

Whether the flag is a deletion request

type'flag' | 'deletion' required

The type of the flag (e.g., flag or deletion)

reason_namestring nullable

The configured flag reason this flag was raised under

needs_parent_idboolean required

Whether the flag requires a parent post ID before it can be resolved

needs_staff_reasonboolean required

Whether the flag requires a staff-supplied reason

notestring nullable

Additional explanation regarding the flag

Changes

  • 7eb984be63caRevision changes
    • ▲

      the response property / became optional for the status

    • ○

      added the optional property / to the response with the status

    • ○

      added the required property / to the response with the status

    • ○

      added the required property / to the response with the status

  • 7072faf64cffRevision changes
    • ○

      added the optional property / to the response with the status