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

# Get all patient level treatments

`POST /treatments/patient`

## Request

- Base URL: `https://www.cbioportal.org/api`
- URL: `https://www.cbioportal.org/api/treatments/patient`
- Auth: none declared
- TypeScript: <https://skmtc.dev/waldronlab/apis/cbioportal-web-public-api-beta/docs/treatments/patient/post.ts> (a function with typed inputs; its response is checked against the schema)

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

- PatientTreatmentRow[]
  - `count` integer
  - `samples` ClinicalEventSample[]
    - `patientId` string
    - `sampleId` string
    - `studyId` string
    - `timeTaken` integer
  - `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

[Operation history](https://skmtc.dev/waldronlab/apis/cbioportal-web-public-api-beta/changes/treatments/patient/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.dev/waldronlab/apis/cbioportal-web-public-api-beta/revisions/99265965e66b?raw)