> ## 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 RHEED Timeseries

> Retrieve processed RHEED timeseries data

Returns processed RHEED results data for plotting timeseries information, including intensity series organized by azimuthal angle.

<ParamField path="data_id" type="string" required>
  The data entry UUID for the RHEED recording
</ParamField>

<ParamField query="return_null_if_missing" type="boolean" default="false">
  Return `null` instead of an error if no processed data exists yet
</ParamField>

<ParamField query="last_n" type="integer">
  Return only the last N data points (useful for incremental fetching during streams)
</ParamField>

<ParamField query="elapsed_seconds" type="number">
  Return only data points from the last N seconds (useful for incremental fetching during streams)
</ParamField>

## Response

<ResponseField name="calibration_id" type="string">
  ID of the calibration used for processing
</ResponseField>

<ResponseField name="series_by_angle" type="array">
  Timeseries data organized by azimuthal angle, each containing fingerprint series data
</ResponseField>

<ResponseField name="lattice_spacing_multiples" type="object">
  Lattice spacing multiple values derived from the diffraction pattern
</ResponseField>

<ResponseField name="regions" type="object">
  Region definitions used for intensity extraction
</ResponseField>

<ResponseField name="series_max_time" type="number">
  Maximum timestamp in the timeseries (seconds)
</ResponseField>

<RequestExample>
  ```python SDK theme={null}
  from atomscale import Client

  client = Client(api_key="YOUR_API_KEY")
  results = client.get(data_ids="d290f1ee-6c54-4b01-90e6-d701748f0851")
  video = results[0]  # RHEEDVideoResult
  print(video.timeseries_data)
  ```

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

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

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

<ResponseExample>
  ```json 200 theme={null}
  {
    "calibration_id": "cal_001",
    "series_by_angle": [
      {
        "angle": 0,
        "series": [...]
      }
    ],
    "lattice_spacing_multiples": {},
    "regions": {},
    "series_max_time": 1800.5
  }
  ```
</ResponseExample>