---
title: "Return bounded ranked molecule rows for an entitled Generated Data pool."
method: POST
path: "/v2/data-access/ranked-molecules"
tags: ["Data Access"]
---

# Return bounded ranked molecule rows for an entitled Generated Data pool.

`POST /v2/data-access/ranked-molecules`

## Request

- Base URL: `https://api.omtx.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.omtx.ai/v2/data-access/ranked-molecules`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

## Headers

- `Idempotency-Key` string, required

## Request body

- object: Bounded ranked-row read for an entitled Generated Data snapshot.
  - `protein_uuid` string, required: Target protein UUID
  - `pool` 'binders' | 'non_binders'
  - `limit` integer
  - `sort_by` 'vintage_rank' | 'isoform_rp1k' | 'uniprot_rp1k' | 'isoform_selectivity' | 'uniprot_selectivity' | 'binding_score' | 'selectivity_score' | 'MW' | 'logP' | 'PSA' | 'HBD' | 'HBA'
  - `sort_order` 'desc' | 'asc', nullable
  - `scan_scope` 'preview' | 'full'
  - `max_shards` integer: Maximum shards scanned when scan_scope is preview.

## Response `200`

Successful Response

- unknown

---

[API](https://skmtc.dev/omtx/apis/gateway.md) - [All operations](https://skmtc.dev/omtx/apis/gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/omtx/apis/gateway/revisions/232715a75205?raw)