---
title: "Get all sample level treatments"
method: POST
path: "/treatments/sample"
tags: ["Treatments"]
---

# Get all sample level treatments

`POST /treatments/sample`

## Query parameters

- `tier` 'Agent' | 'AgentClass' | 'AgentTarget'

## Request body

- StudyViewFilter
  - `alterationFilter` AlterationFilter
    - `copyNumberAlterationEventTypes` object
    - `includeDriver` boolean
    - `includeGermline` boolean
    - `includeSomatic` boolean
    - `includeUnknownOncogenicity` boolean
    - `includeUnknownStatus` boolean
    - `includeUnknownTier` boolean
    - `includeVUS` boolean
    - `mutationEventTypes` object
    - `structuralVariants` boolean
    - `tiersBooleanMap` object
  - `caseLists` array[]
    - string[]
  - `clinicalDataFilters` ClinicalDataFilter[]
    - `attributeId` string
    - `values` DataFilterValue[]
      - `end` number
      - `start` number
      - `value` string
  - `clinicalEventFilters` DataFilter[]
    - `values` DataFilterValue[]
      - `end` number
      - `start` number
      - `value` string
  - `customDataFilters` ClinicalDataFilter[]
    - `attributeId` string
    - `values` DataFilterValue[]
      - `end` number
      - `start` number
      - `value` string
  - `geneFilters` GeneFilter[]
    - `geneQueries` array[]
      - GeneFilterQuery[]
        - `alterations` string[]
        - `entrezGeneId` integer
        - `hugoGeneSymbol` string
        - `includeDriver` boolean
        - `includeGermline` boolean
        - `includeSomatic` boolean
        - `includeUnknownOncogenicity` boolean
        - `includeUnknownStatus` boolean
        - `includeUnknownTier` boolean
        - `includeVUS` boolean
        - `tiersBooleanMap` object
    - `molecularProfileIds` string[]
  - `genericAssayDataFilters` GenericAssayDataFilter[]
    - `profileType` string
    - `stableId` string
    - `values` DataFilterValue[]
      - `end` number
      - `start` number
      - `value` string
  - `genomicDataFilters` GenomicDataFilter[]
    - `hugoGeneSymbol` string
    - `profileType` string
    - `values` DataFilterValue[]
      - `end` number
      - `start` number
      - `value` string
  - `genomicProfiles` array[]
    - string[]
  - `patientTreatmentFilters` AndedPatientTreatmentFilters
    - `filters` OredPatientTreatmentFilters[]
      - `filters` PatientTreatmentFilter[]
        - `treatment` string
  - `patientTreatmentGroupFilters` AndedPatientTreatmentFilters
    - `filters` OredPatientTreatmentFilters[]
      - `filters` PatientTreatmentFilter[]
        - `treatment` string
  - `patientTreatmentTargetFilters` AndedPatientTreatmentFilters
    - `filters` OredPatientTreatmentFilters[]
      - `filters` PatientTreatmentFilter[]
        - `treatment` string
  - `sampleIdentifiers` SampleIdentifier[]
    - `sampleId` string
    - `studyId` string
  - `sampleTreatmentFilters` AndedSampleTreatmentFilters
    - `filters` OredSampleTreatmentFilters[]
      - `filters` SampleTreatmentFilter[]
        - `time` 'Post' | 'Pre'
        - `treatment` string
  - `sampleTreatmentGroupFilters` AndedSampleTreatmentFilters
    - `filters` OredSampleTreatmentFilters[]
      - `filters` SampleTreatmentFilter[]
        - `time` 'Post' | 'Pre'
        - `treatment` string
  - `sampleTreatmentTargetFilters` AndedSampleTreatmentFilters
    - `filters` OredSampleTreatmentFilters[]
      - `filters` SampleTreatmentFilter[]
        - `time` 'Post' | 'Pre'
        - `treatment` string
  - `structuralVariantFilters` StudyViewStructuralVariantFilter[]
    - `molecularProfileIds` string[]
    - `structVarQueries` array[]
      - StructuralVariantFilterQuery[]
        - `gene1Query` StructuralVariantGeneSubQuery
          - `entrezId` integer
          - `hugoSymbol` string
          - `specialValue` 'ANY_GENE' | 'NO_GENE'
        - `gene2Query` StructuralVariantGeneSubQuery
          - `entrezId` integer
          - `hugoSymbol` string
          - `specialValue` 'ANY_GENE' | 'NO_GENE'
        - `includeDriver` boolean
        - `includeGermline` boolean
        - `includeSomatic` boolean
        - `includeUnknownOncogenicity` boolean
        - `includeUnknownStatus` boolean
        - `includeUnknownTier` boolean
        - `includeVUS` boolean
        - `tiersBooleanMap` object
  - `studyIds` string[]

## Response `200`

OK

- SampleTreatmentRow[]
  - `count` integer
  - `samples` ClinicalEventSample[]
    - `patientId` string
    - `sampleId` string
    - `studyId` string
    - `timeTaken` integer
  - `time` 'Post' | 'Pre'
  - `treatment` string

## Changes

- **2021-10-04** `e741f34f8126` — 1 info
  - added the new optional `query` request parameter `tier`
- **2020-08-26** `ccb5c5f910f0` — 1 info
  - endpoint added
- **2019-04-05** `df161d3dbe1b` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/waldronlab/apis/cbioportal-web-public-api-beta/changes/treatments/sample/post.md)

---

[API](https://skmtc.dev/waldronlab/apis/cbioportal-web-public-api-beta.md) · [All operations](https://skmtc.dev/waldronlab/apis/cbioportal-web-public-api-beta/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/waldronlab/cbioportal-web-public-api-beta/revisions/99265965e66b/schema)