# Retrieve the latest value

Endpoint: GET /time-series/{twinId}/latest
Version: v3
Security: oauth2

## Path parameters:

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

## Query parameters:

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

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

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

## Response 200 fields (application/json):

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

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

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

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

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

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

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

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