# Retrieve multiple time series

Endpoint: POST /time-series/ids
Version: v3
Security: oauth2

## Query parameters:

  - `start` (string, required)
    Start timestamp for the request
    Example: "2024-10-01T00:00:00Z"

  - `end` (string, required)
    End timestamp for the request
    Example: "2024-10-07T00:00:00Z"

  - `pageSize` (integer, required)
    Number of items returned per page (minimum 1)
    Example: 100

  - `continuationToken` (string, required)
    Token for retrieving the next page of results
    Example: "CgAAYQAAAAAAABQ..."

  - `includeDataQuality` (boolean)
    If true, include data quality metrics in the response

## Response 200 fields (application/json):

  - `data` (array,null)
    Gets or sets the data.
    Example: [{"connectorId":"TW-CC-01","twinId":"TW-DD-II-01","externalId":"PNTC4Jm8vXy7bWq9rT5sHkLz2p","sourceTimestamp":"2024-10-01T12:34:56Z","scalarValue":42,"properties":{"customerEquipmentId":"X-1234"},"dataQuality":{"offline":false,"valueOutOfRange":false,"sparse":false,"flatline":false,"delayed":false}}]

  - `data.connectorId` (string,null)
    Id of the connector
    Example: "TW-CC-01"

  - `data.twinId` (string,null)
    Id of the twin
    Example: "TW-DD-II-01"

  - `data.externalId` (string,null)
    External Id of the twin
    Example: "PNTC4Jm8vXy7bWq9rT5sHkLz2p"

  - `data.sourceTimestamp` (string)
    Timestamp when the source recorded the value in ISO 8601 format
    Example: "2024-10-01T12:34:56Z"

  - `data.enqueuedTimestamp` (string)
    Timestamp when Willow received the value in ISO 8601 format
    Example: "2024-10-01T12:35:00Z"

  - `data.scalarValue` (any)
    The data value being trended
    Example: 42

  - `data.properties` (object)
    Properties or metadata about the observation or event being trended.
    Example: {"customerEquipmentId":"X-1234"}

  - `data.dataQuality` (any)
    Example: {"offline":false,"valueOutOfRange":false,"sparse":false,"flatline":false,"delayed":false}

  - `continuationToken` (string,null)
    Gets or sets the continuation token.
    Example: "CgAAYQAAAAAAABQ..."

  - `errorList` (any)


## Response 404 fields