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

> Retrieve raw data for a specific data entry

Returns the raw, unprocessed data associated with 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>

## Response

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

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

<ResponseField name="file_name" type="string">
  Original filename
</ResponseField>

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

When `return_as` is `bytes`, the response body contains the raw file binary data.

<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="raw/",
      data_type="raw",
  )
  ```

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

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

  # Download the actual file
  file_response = requests.get(raw_data["url"])
  ```

  ```bash cURL theme={null}
  curl "https://api.atomscale.ai/data_entries/raw_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/raw/d290f1ee.mp4?token=...",
    "file_name": "rheed_video_2024_01_15.mp4",
    "file_format": "mp4"
  }
  ```
</ResponseExample>