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

> Retrieve secondary ion mass spectrometry depth profiles

Returns secondary ion mass spectrometry (SIMS) depth profile data for a data entry, as a list of profiles with one entry per chemical species. Each profile pairs a depth axis with the measured concentration at each depth.

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

## Response

Returns an array of depth profile objects, one per species, ordered by species name. If no SIMS data exists for the entry, an empty array is returned.

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

<ResponseField name="id" type="string">
  SIMS depth profile identifier
</ResponseField>

<ResponseField name="processed_data_id" type="string">
  Processed data entry UUID
</ResponseField>

<ResponseField name="species_name" type="string">
  Chemical species for this depth profile (e.g., `Si`, `O`)
</ResponseField>

<ResponseField name="depths" type="array">
  Depth values
</ResponseField>

<ResponseField name="depth_units" type="string">
  Unit for the `depths` values (e.g., `nm`)
</ResponseField>

<ResponseField name="concentrations" type="array">
  Concentration values corresponding to each depth
</ResponseField>

<ResponseField name="concentration_units" type="string">
  Unit for the `concentrations` values (e.g., `atoms/cm^3`)
</ResponseField>

<ResponseField name="species_metadata" type="object">
  Additional metadata for this species profile
</ResponseField>

<ResponseField name="last_updated" type="string">
  ISO 8601 timestamp of last update
</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")
  sims = results[0]  # SIMSResult
  print(sims.depth_profiles)
  ```

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

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

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

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "data_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "id": "sims_001",
      "processed_data_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "species_name": "Si",
      "depths": [0, 10, 20, 30, 40],
      "depth_units": "nm",
      "concentrations": [1.2e18, 3.4e18, 5.1e18, 2.0e18, 8.0e17],
      "concentration_units": "atoms/cm^3",
      "species_metadata": {},
      "last_updated": "2024-01-15T10:35:00Z"
    }
  ]
  ```
</ResponseExample>