> ## 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 Processed Data

> Retrieve processed data for a data entry

Returns processed data for a data entry. You must specify how you want the data returned using the `return_as` parameter.

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

<ParamField query="return_as" type="string" required>
  How to return the data: `bytes` (raw binary), `url-download` (pre-signed download URL), or `url-embed` (pre-signed embeddable URL)
</ParamField>

<ParamField query="filter" type="string" default="none">
  Filter type: `video` to retrieve processed video, or `none`
</ParamField>

<ParamField query="is_stream" type="boolean" default="false">
  Set to `true` when retrieving processed data for a streaming session
</ParamField>

<ParamField query="suffix" type="string">
  Optional suffix to append to the processed data file path
</ParamField>

## Response

When `return_as` is `url-download` or `url-embed`:

<ResponseField name="url" type="string">
  Pre-signed URL for accessing the processed data file
</ResponseField>

<ResponseField name="file_name" type="string">
  Filename of the processed data
</ResponseField>

<ResponseField name="file_format" type="string">
  File format/extension
</ResponseField>

<ResponseField name="metadata" type="object">
  Additional metadata about the processed data
</ResponseField>

Returns `null` if no processed data is available yet.

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

  client = Client(api_key="YOUR_API_KEY")
  client.download_videos(
      data_ids="d290f1ee-6c54-4b01-90e6-d701748f0851",
      dest_dir="processed/",
      data_type="processed",
  )
  ```

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

  response = requests.get(
      "https://api.atomscale.ai/data_entries/processed_data/d290f1ee-6c54-4b01-90e6-d701748f0851",
      headers={"X-API-KEY": "YOUR_API_KEY"},
      params={"return_as": "url-download"}
  )
  processed = response.json()
  ```

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

<ResponseExample>
  ```json 200 theme={null}
  {
    "url": "https://storage.atomscale.ai/processed/d290f1ee.json?token=...",
    "file_name": "rheed_results.json",
    "file_format": "json",
    "metadata": {}
  }
  ```
</ResponseExample>