---
title: "List samples"
method: GET
path: "/v2/quality/samples"
tags: ["Quality Samples"]
---

# List samples

`GET /v2/quality/samples`

## Request

- Base URL: `https://api.cloud.precisely.com`
- URL: `https://api.cloud.precisely.com/v2/quality/samples`
- Auth: HTTP bearer

Returns samples, optionally filtered and paginated.

Filtering behavior:
The 'tags' parameter performs an exact match against one or more tags.
The 'sampleName' parameter performs an exact match on the sample name.
The 'searchKey' parameter performs a case-insensitive partial match against both the sample name and the asset name path, and cannot be combined with the other filter parameters (tags, sampleName, assetTypePath, assetNamePath, sampleType).
The 'assetTypePath' parameter performs an exact match on the asset type path.
The 'assetNamePath' parameter performs an exact match on the full asset name path.
The 'sampleType' parameter performs an exact match on the sample type (e.g. "uploaded" or "generated").

## Query parameters

- `tags` string[]
- `sampleName` string
- `searchKey` string
- `assetTypePath` string
- `assetNamePath` string
- `sampleType` string
- `page` integer
- `size` integer
- `ascending` boolean
- `sortBy` string

## Response `200`

List of sample summaries

- SampleSummary[]
  - `assetNamePath` string
  - `assetTypePath` string
  - `createdDate` string, date-time
  - `daysLeftToPurge` integer
  - `lastModifiedDate` string, date-time
  - `name` string
  - `numberOfRows` integer
  - `sampleStorageProvider` string
  - `sampleType` string
  - `tags` string[]

## Other responses

- `400`: Invalid filter combination (e.g. searchKey combined with other filters)
- `500`: Internal server error

---

[API](https://skmtc.dev/precisely/apis/verify-api-portal.md) · [All operations](https://skmtc.dev/precisely/apis/verify-api-portal/llms.txt) · [OpenAPI document](https://skmtc.dev/precisely/apis/verify-api-portal/revisions/380735465266?raw)