> ## 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 Physical Samples

> Retrieve physical samples in your organization

Returns physical samples for your organization with optional filtering.

<ParamField query="physical_sample_id" type="string">
  Filter by a specific physical sample UUID
</ParamField>

<ParamField query="has_data_item" type="boolean">
  Filter to samples that have (or don't have) associated data items
</ParamField>

## Response

Returns an array of physical sample objects.

<ResponseField name="id" type="string">
  Physical sample UUID
</ResponseField>

<ResponseField name="name" type="string">
  Sample name or label
</ResponseField>

<ResponseField name="created_datetime" type="string">
  ISO 8601 timestamp of creation
</ResponseField>

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

<ResponseField name="owner_id" type="string">
  User ID of the sample owner
</ResponseField>

<ResponseField name="owner_name" type="string">
  Display name of the sample owner
</ResponseField>

<ResponseField name="num_data_items" type="integer">
  Number of data entries associated with this sample
</ResponseField>

<ResponseField name="growth_instrument" type="object">
  Growth instrument details
</ResponseField>

<ResponseField name="target_material" type="object">
  Target material information
</ResponseField>

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

<ResponseField name="detail_notes" type="object">
  Sample notes content
</ResponseField>

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

  client = Client(api_key="YOUR_API_KEY")
  samples = client.list_physical_samples()
  ```

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

  response = requests.get(
      "https://api.atomscale.ai/physical_samples/",
      headers={"X-API-KEY": "YOUR_API_KEY"}
  )
  samples = response.json()
  ```

  ```bash cURL theme={null}
  curl "https://api.atomscale.ai/physical_samples/" \
    -H "X-API-KEY: YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
      "name": "GaAs-001",
      "created_datetime": "2024-01-12T09:00:00Z",
      "last_updated": "2024-01-15T10:00:00Z",
      "owner_id": "user_abc123",
      "owner_name": "Jane Smith",
      "num_data_items": 8,
      "growth_instrument": null,
      "target_material": null,
      "projects": [
        {
          "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
          "name": "GaAs MBE Development"
        }
      ],
      "detail_notes": null
    }
  ]
  ```
</ResponseExample>