---
title: "Fetch samples by ID"
method: POST
path: "/samples/fetch"
tags: ["Samples"]
---

# Fetch samples by ID

`POST /samples/fetch`

## Query parameters

- `projection` 'DETAILED' | 'ID' | 'META' | 'SUMMARY'

## Request body

- SampleFilter
  - `sampleIdentifiers` SampleIdentifier[]
    - `sampleId` string
    - `studyId` string
  - `sampleListIds` string[]
  - `uniqueSampleKeys` string[]

## Response `200`

OK

- Sample[]
  - `copyNumberSegmentPresent` boolean
  - `patientId` string, required
  - `sampleId` string, required
  - `sampleType` 'BLOOD_NORMAL' | 'METASTATIC' | 'PRIMARY_BLOOD_TUMOR' | 'PRIMARY_SOLID_TUMOR' | 'RECURRENT_BLOOD_TUMOR' | 'RECURRENT_SOLID_TUMOR' | 'SOLID_NORMAL'
  - `sequenced` boolean
  - `studyId` string, required
  - `uniquePatientKey` string
  - `uniqueSampleKey` string

---

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