> For the complete documentation index, see [llms.txt](https://docs.icube.co.th/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.icube.co.th/icube-platform/icube-server/integration/provider/integration-provider-api-document/get-multiple-tag-values.md).

# Get multiple Tag values

Fetches the values of specified tags identified by their names, with optional filters for time range and status.

**Example URL**

```
https://api.icube.co.th/integration/webapi/tag/value?name=B15-Status,VT-01&starttime=*-10y&endtime=*&statusData=18
```

`Last Update: 5 NOV 2024`

#### Retrieve Tag Values with Filters

**Method:** `GET`

**URL:** `{{base_url}}/tag/value?name={tagname}&starttime={starttime}&endtime={endtime}&statusData={statusData}`

***

**Query Parameters:**

<table><thead><tr><th width="233">Parameter</th><th width="125">Required</th><th>Description</th></tr></thead><tbody><tr><td><code>name</code></td><td>Yes</td><td>Comma-separated list of tag names to retrieve values for (e.g., <code>B15-Status,VT-01</code>).</td></tr><tr><td><code>starttime</code></td><td>Yes</td><td>Starting time for filtering the data (e.g., <code>*-10y</code>)<br>(Default: <code>starttime=*-10m</code>)</td></tr><tr><td><code>endtime</code></td><td>Yes</td><td>Ending time for filtering the data (e.g., <code>*</code>)<br>(Default: <code>endtime=*</code>)</td></tr><tr><td><code>statusData</code></td><td>No</td><td>A filter for the status of the tag values, acting like a WHERE clause in PostgreSQL (only integer).</td></tr></tbody></table>

**Time Expression:**

<table><thead><tr><th width="233">Expression</th><th>Description</th></tr></thead><tbody><tr><td><code>sec</code></td><td>Second</td></tr><tr><td><code>m</code></td><td>Minute</td></tr><tr><td><code>h</code></td><td>Hour</td></tr><tr><td><code>d</code></td><td>Day</td></tr><tr><td><code>mo</code></td><td>Month</td></tr><tr><td><code>y</code></td><td>Year</td></tr><tr><td><code>*</code></td><td>Present</td></tr><tr><td><code>-</code></td><td>Go back (e.g., <code>*-10d</code> means go back 10 days)</td></tr><tr><td><code>+</code></td><td>Go forward (e.g., <code>*+10mo</code> means go forward 10 months)</td></tr></tbody></table>

***

**Response Example:**

```json
{
    "data": [
        {
            "tagname": "string",
            "description": "string or null",
            "subDescription": "string or null",
            "value": "string",
            "unit": "string",
            "quality": integer,
            "status": integer,
            "timeStamp": "datetime"
        }
    ]
}

```

**Response Details:**

<table><thead><tr><th width="200">Object</th><th width="161">Data Type</th><th>Description</th></tr></thead><tbody><tr><td><code>data</code></td><td>array</td><td>Array of tag value objects returned from the API.</td></tr><tr><td><code>tagname</code></td><td>string</td><td>Name of the tag.</td></tr><tr><td><code>description</code></td><td>string/null</td><td>Description of the tag.</td></tr><tr><td><code>subDescription</code></td><td>string/null</td><td>Additional description of the tag (if available).</td></tr><tr><td><code>value</code></td><td>string</td><td>The value of the tag.</td></tr><tr><td><code>unit</code></td><td>string</td><td>Unit of measurement for the tag value.</td></tr><tr><td><code>quality</code></td><td>integer</td><td>Quality indicator of the tag value.</td></tr><tr><td><code>status</code></td><td>integer</td><td>Status code associated with the tag value.</td></tr><tr><td><code>timeStamp</code></td><td>datetime</td><td>Timestamp when the tag value was recorded.</td></tr></tbody></table>