Sign in
tag_aliases

Get a list of tag aliases

Changed on

Returns a list of tag aliases filtered by various criteria.

get/tag_aliases.json

Request

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

search[name_matches]string

Filter by matching names

search[antecedent_name]string

Filter by the antecedent name of the alias

search[consequent_name]string

Filter by the consequent name of the alias

search[creator_name]string

Filter by the creator's username

search[approver_name]string

Filter by the approver's username

search[antecedent_tag_category]integer

Filter by the tag category of the antecedent tag

search[consequent_tag_category]integer

Filter by the tag category of the consequent tag

search[status]'Approved' | 'Active' | 'Pending' | 'Deleted' | 'Retired' | 'Processing' | 'Queued'

Filter by the status of the tag alias

search[order]'id_desc' | 'id_asc' | 'status' | 'created_at' | 'updated_at' | 'name' | 'tag_count'

Order the results by a specific field

search[created_at]string

Filter by the creation date of the request

search[updated_at]string

Filter by the last update date of the request

Response

A list of tag aliases matching the search criteria

idinteger required

The unique ID of the tag alias

antecedent_namestring required

The name of the antecedent tag

consequent_namestring required

The name of the consequent tag

statusstring required

The status of the tag alias. One of active, deleted, pending, processing, queued, retired, or error: <message> carrying the failure text when processing failed.

created_atstring date-time required

The timestamp when the tag alias was created

updated_atstring date-time required

The timestamp when the tag alias was last updated

reasonstring

The reason for creating the tag alias

creator_idinteger required

The ID of the user who created the tag alias

approver_idinteger nullable

The ID of the user who approved the tag alias, if applicable

forum_post_idinteger

The ID of the associated forum post

forum_topic_idinteger

The ID of the associated forum topic

post_countinteger

The number of posts associated with the tag alias

Changes

  • 7eb984be63caRevision changes
    • ○

      removed the active enum value from the / response property for the response status

    • ○

      removed the deleted enum value from the / response property for the response status

    • ○

      removed the pending enum value from the / response property for the response status

    • ○

      removed the processing enum value from the / response property for the response status

    • ○

      removed the queued enum value from the / response property for the response status

    • ○

      removed the retired enum value from the / response property for the response status

    • ○

      the / response's property pattern ^(active|deleted|pending|processing|queued|retired|error: .*)$ was added for the status

  • d1d05ce5fa8fRevision changes
    • ○

      removed the approved enum value from the / response property for the response status