Sign in
appeals

Get a list of appeals

Changed on

Returns appeals visible to the current user. Non-staff users only see their own appeals. Several search filters are restricted to staff.

get/appeals.json

Request

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

search[qtype]'flag'

The kind of appeal

Filter by appeal type

search[status]'pending' | 'pending_unclaimed' | 'pending_claimed' | 'partial' | 'approved' | 'rejected' | 'handled'

Filter by appeal status

search[order]string

Sort order

search[creator_id]integer

Filter by creator ID. Non-staff may only filter on their own ID.

search[disp_id]integer

Filter by the appealed content ID (staff only)

search[creator_name]string

Filter by creator username (staff only)

search[accused_name]string

Filter by accused username (staff only)

search[accused_id]integer

Filter by accused user ID (staff only)

search[claimant_id]integer

Filter by claimant ID (staff only)

search[claimant_name]string

Filter by claimant username (staff only)

search[reason]string

Filter by reason text (staff only)

Response

A list of appeals matching the search criteria

idinteger required

The unique ID of the appeal

creator_idinteger required

The ID of the user who created the appeal

disp_idinteger required

The ID of the appealed record (e.g. a PostFlag ID when qtype=flag)

qtype'flag' required

The kind of appeal

status'pending' | 'partial' | 'approved' | 'rejected' required

The current status of the appeal

reasonstring required

The reason given for the appeal

responsestring required

The handler's response to the appeal

claimant_idinteger nullable

The ID of the staff member currently claiming the appeal

handler_idinteger nullable

The ID of the staff member who last updated the appeal

accused_idinteger nullable

The ID of the user the appeal is filed against (e.g. the flag creator for flag appeals)

created_atstring date-time required

The time the appeal was created

updated_atstring date-time required

The last time the appeal was updated

Changes

  • 7eb984be63caRevision changes
    • ●

      removed the optional property / from the response with the status

    • ●

      added the new rejected enum value to the / response property for the response status

    • ○

      added the new enum value handled to the query request parameter search[status]

    • ○

      added the new enum value rejected to the query request parameter search[status]

  • 4bd34c3994c1Revision changes
    • ○

      the response property / became required for the status

    • ○

      the response property / became required for the status

    • ○

      the response property / became required for the status

    • ○

      the response property / became required for the status

    • ○

      the response property / became required for the status

    • ○

      the response property / became required for the status

    • ○

      the response property / became required for the status

    • ○

      the response property / became required for the status

    • ○

      the response property / became required for the status