# Post query to list account tags or search for single tag

Gets the list of all tags, or filtered by tag prefix, for an account

Endpoint: POST /v1/analytics/tags
Version: 3.0.0
Security: basicAuth

## Request fields (application/json):

  - `pagination` (object)

  - `pagination.sort` (string)
    Colon-separated value indicating column name and sort direction e.g. 'lastseen:desc'.

  - `pagination.skip` (integer)
    The number of items to skip over when satisfying the request. To get the first page of data set skip to zero.  Then increment the skip by the limit for subsequent calls.

  - `pagination.limit` (integer)
    The maximum number of items returned in the response. Default 10 max 1000.

  - `pagination.total` (integer)
    The total number of tags matching the search criteria.

  - `pagination.include_total` (boolean)
    Boolean indicating whether or not to include total number of items. Default false.

  - `include_subaccounts` (boolean)
    Boolean indicating whether or not to include data from all subaccounts. Default false.

  - `include_metrics` (boolean)
    Boolean indicating whether or not to include metrics for tags. Default false.  When true max limit is 20.

  - `tag` (string)
    The tag or tag prefix.

## Response 200 fields (application/json):

  - `items` (array, required)

  - `items.account_id` (string, required)

  - `items.parent_account_id` (string, required)

  - `items.tag` (string, required)

  - `items.description` (string, required)

  - `items.first_seen` (object)

  - `items.last_seen` (object)

  - `items.metrics` (object)

  - `items.metrics.accepted_incoming_count` (integer)

  - `items.metrics.accepted_outgoing_count` (integer)

  - `items.metrics.accepted_count` (integer)

  - `items.metrics.delivered_smtp_count` (integer)

  - `items.metrics.delivered_http_count` (integer)

  - `items.metrics.delivered_optimized_count` (integer)

  - `items.metrics.delivered_count` (integer)

  - `items.metrics.stored_count` (integer)

  - `items.metrics.sent_count` (integer)

  - `items.metrics.opened_count` (integer)

  - `items.metrics.clicked_count` (integer)

  - `items.metrics.unique_opened_count` (integer)

  - `items.metrics.unique_clicked_count` (integer)

  - `items.metrics.unsubscribed_count` (integer)

  - `items.metrics.complained_count` (integer)

  - `items.metrics.failed_count` (integer)

  - `items.metrics.temporary_failed_count` (integer)

  - `items.metrics.permanent_failed_count` (integer)

  - `items.metrics.esp_block_count` (integer)

  - `items.metrics.temporary_failed_esp_block_count` (integer)

  - `items.metrics.permanent_failed_esp_block_count` (integer)

  - `items.metrics.rate_limit_count` (integer)

  - `items.metrics.webhook_count` (integer)

  - `items.metrics.permanent_failed_optimized_count` (integer)

  - `items.metrics.permanent_failed_old_count` (integer)

  - `items.metrics.bounced_count` (integer)

  - `items.metrics.hard_bounces_count` (integer)

  - `items.metrics.soft_bounces_count` (integer)

  - `items.metrics.delayed_bounce_count` (integer)

  - `items.metrics.suppressed_bounces_count` (integer)

  - `items.metrics.suppressed_unsubscribed_count` (integer)

  - `items.metrics.suppressed_complaints_count` (integer)

  - `items.metrics.delivered_first_attempt_count` (integer)

  - `items.metrics.delayed_first_attempt_count` (integer)

  - `items.metrics.delivered_subsequent_count` (integer)

  - `items.metrics.delivered_two_plus_attempts_count` (integer)

  - `items.metrics.processed_count` (integer)

  - `items.metrics.delivered_rate` (string)

  - `items.metrics.opened_rate` (string)

  - `items.metrics.clicked_rate` (string)

  - `items.metrics.unique_opened_rate` (string)

  - `items.metrics.unique_clicked_rate` (string)

  - `items.metrics.unsubscribed_rate` (string)

  - `items.metrics.complained_rate` (string)

  - `items.metrics.bounce_rate` (string)

  - `items.metrics.hard_bounce_rate` (string)

  - `items.metrics.soft_bounce_rate` (string)

  - `items.metrics.fail_rate` (string)

  - `items.metrics.permanent_fail_rate` (string)

  - `items.metrics.temporary_fail_rate` (string)

  - `items.metrics.delayed_rate` (string)

  - `items.metrics.email_validation_count` (integer)

  - `items.metrics.email_validation_public_count` (integer)

  - `items.metrics.email_validation_valid_count` (integer)

  - `items.metrics.email_validation_single_count` (integer)

  - `items.metrics.email_validation_bulk_count` (integer)

  - `items.metrics.email_validation_list_count` (integer)

  - `items.metrics.email_validation_mailgun_count` (integer)

  - `items.metrics.email_validation_mailjet_count` (integer)

  - `items.metrics.email_preview_count` (integer)

  - `items.metrics.email_preview_failed_count` (integer)

  - `items.metrics.link_validation_count` (integer)

  - `items.metrics.link_validation_failed_count` (integer)

  - `items.metrics.seed_test_count` (integer)

  - `items.metrics.accessibility_count` (integer)

  - `items.metrics.accessibility_failed_count` (integer)

  - `items.metrics.image_validation_count` (integer)

  - `items.metrics.image_validation_failed_count` (integer)

  - `items.account_name` (string, required)

  - `pagination` (object)

  - `pagination.sort` (string)
    Colon-separated value indicating column name and sort direction e.g. 'lastseen:desc'.

  - `pagination.skip` (integer)
    The number of items to skip over when satisfying the request. To get the first page of data set skip to zero.  Then increment the skip by the limit for subsequent calls.

  - `pagination.limit` (integer)
    The maximum number of items returned in the response. Default 10 max 1000.

  - `pagination.total` (integer)
    The total number of tags matching the search criteria.

  - `pagination.include_total` (boolean)
    Boolean indicating whether or not to include total number of items. Default false.

## Response 400 fields (application/json):

  - `message` (string, required)
    Response message