> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atomscale.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Staged Timeseries

> Retrieve timeseries data from a staged upload

Returns timeseries data associated with a staged data entry. This is used for instrument timeseries data that has been uploaded but may not yet be fully processed.

<ParamField path="data_id" type="string" required>
  The data entry UUID
</ParamField>

## Response

Returns an array of timeseries channel objects.

<ResponseField name="timeseries_id" type="string">
  Unique identifier for this timeseries channel
</ResponseField>

<ResponseField name="data_id" type="string">
  Data entry UUID
</ResponseField>

<ResponseField name="name" type="string">
  Channel name
</ResponseField>

<ResponseField name="unit" type="string">
  Measurement unit for the values
</ResponseField>

<ResponseField name="component" type="string">
  Component or sub-channel identifier
</ResponseField>

<ResponseField name="unix_times" type="array">
  Array of Unix timestamps (milliseconds)
</ResponseField>

<ResponseField name="values" type="array">
  Array of measurement values corresponding to the timestamps
</ResponseField>

<ResponseField name="last_updated" type="string">
  ISO 8601 timestamp of last update
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.atomscale.ai/data_entries/raw_data/staged/timeseries/d290f1ee-6c54-4b01-90e6-d701748f0851" \
    -H "X-API-KEY: YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.atomscale.ai/data_entries/raw_data/staged/timeseries/d290f1ee-6c54-4b01-90e6-d701748f0851",
      headers={"X-API-KEY": "YOUR_API_KEY"}
  )
  timeseries = response.json()
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "timeseries_id": "ts_001",
      "data_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "system": "scienta",
      "version": "1.0",
      "name": "temperature",
      "unit": "C",
      "component": "substrate",
      "unix_times": [1705312200000, 1705312201000, 1705312202000],
      "values": [550.1, 550.3, 550.5],
      "last_updated": "2024-01-15T10:30:02Z"
    }
  ]
  ```
</ResponseExample>
