# Tag

## Get a list of tags.

<mark style="color:blue;">`GET`</mark> `https://api.halosecurity.com/api/v1/tag/list.json`

Returns a paginated list of tags.

<https://app.halosecurity.com/user/security/tags/>

#### Query Parameters

| Name       | Type    | Description                                                                                                                                                              |
| ---------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| sort       | Integer | <p><code>0</code></p><p>= none (default)</p>                                                                                                                             |
| sort\_desc | Integer | <p><code>0</code> = No (default)</p><p><code>1</code> = Yes</p>                                                                                                          |
| type       | Integer | <p><code>0</code> = Return all (default)</p><p><code>1</code> = Return type Auto</p><p><code>2</code> = Return type Custom</p><p><code>3</code> = Return type Filter</p> |
| tag        | String  |                                                                                                                                                                          |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "list": [
        {
            "risk_score": 0,
            "targets_not": 0,
            "tag": "blog",
            "type": 2,
            "ports": 1,
            "targets": 1,
            "issues": 1
        }
    ]
}
```

{% endtab %}
{% endtabs %}