Sign in
bans

Get a list of bans

Changed on

Returns a list of bans based on search criteria.

get/bans.json

Request

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

search[user_id]integer

Filter by banned user ID

search[user_name]string

Filter by banned username

search[banner_id]integer

Filter by staff user ID who issued the ban

search[banner_name]string

Filter by staff username who issued the ban

search[reason_matches]string

Filter by ban reason text

search[expired]boolean

Filter by expired status (true = past bans, false = active bans)

search[order]'expires_at_desc'

Sort order

Response

A list of bans

idinteger required

The unique ID of the ban

user_idinteger required

The ID of the banned user

banner_idinteger required

The ID of the staff member who issued the ban

reasonstring required

The reason for the ban

expires_atstring date-time nullable

When the ban expires (null for permanent bans)

created_atstring date-time required

When the ban was created

updated_atstring date-time required

When the ban was last updated

Changes