> ## 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.

# List Data Entries

> Retrieve data catalogue entries with filtering

Returns data catalogue items for your organization with advanced filtering options.

<ParamField query="data_ids" type="array">
  Filter by specific data entry UUIDs
</ParamField>

<ParamField query="physical_sample_ids" type="array">
  Filter by physical sample UUIDs
</ParamField>

<ParamField query="data_type" type="string">
  Filter by characterization source type (e.g., `rheed_video`, `xps`, `sem`, `optical`, `raman`, `photoluminescence`, `metrology`)
</ParamField>

<ParamField query="status" type="string" default="all">
  Filter by pipeline status: `success`, `pending`, `error`, `running`, `all`
</ParamField>

<ParamField query="keywords" type="array">
  Search keywords to filter results
</ParamField>

<ParamField query="include_organization_data" type="boolean" default="true">
  Include data from the entire organization (not just your own)
</ParamField>

<ParamField query="limit" type="integer" default="10000">
  Maximum number of results to return (max 10000)
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Number of results to skip for pagination
</ParamField>

## Response

Returns an array of data catalogue objects. Key fields shown below (the full response includes additional metadata fields).

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

<ResponseField name="raw_name" type="string">
  Original filename of the uploaded data
</ResponseField>

<ResponseField name="char_source_type" type="string">
  Characterization source type (e.g., `rheed_video`, `xps`, `sem`)
</ResponseField>

<ResponseField name="pipeline_status" type="string">
  Processing pipeline status
</ResponseField>

<ResponseField name="upload_datetime" type="string">
  ISO 8601 timestamp of upload
</ResponseField>

<ResponseField name="physical_sample_id" type="string">
  Associated physical sample UUID
</ResponseField>

<ResponseField name="physical_sample_name" type="string">
  Name of the associated physical sample
</ResponseField>

<ResponseField name="tags" type="array">
  Tags associated with this data entry
</ResponseField>

<ResponseField name="projects" type="array">
  Projects this data entry belongs to
</ResponseField>

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

  client = Client(api_key="YOUR_API_KEY")
  results = client.search(data_type="rheed_video", status="success")
  ```

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

  response = requests.get(
      "https://api.atomscale.ai/data_entries/",
      headers={"X-API-KEY": "YOUR_API_KEY"},
      params={"data_type": "rheed_video", "limit": 50}
  )
  data = response.json()
  ```

  ```bash cURL theme={null}
  curl "https://api.atomscale.ai/data_entries/?data_type=rheed_video&limit=50" \
    -H "X-API-KEY: YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "data_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "raw_name": "rheed_video_2024_01_15.mp4",
      "char_source_type": "rheed_video",
      "pipeline_status": "success",
      "upload_datetime": "2024-01-15T10:30:00Z",
      "last_accessed_datetime": "2024-01-15T14:00:00Z",
      "physical_sample_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
      "physical_sample_name": "GaAs-001",
      "tags": [],
      "projects": []
    }
  ]
  ```
</ResponseExample>