---
title: "Get Pair Data"
method: POST
path: "/get_pair_data"
---

# Get Pair Data

`POST /get_pair_data`

Get data for specific MMPs

Body Parameters:

- **prop_changes**: Defines what property data is retrieved for each MMP. List of JSON objects with below parameters:
    - **property_name**: This property_name should match one of the property_names that was passed in the previous calls to /aggregate_transforms and /get_plot_data.
    - **change_type**: Either "fold_change" or "delta", see description for change type under /get_plot_data
    - **base**: OPTIONAL: see description for base in /aggregate_transforms
    - **units**: OPTIONAL: see description for units in /aggregate_transforms
- **construct_id_pairs**: Array of arrays that define the MMPs: [from_construct_id, to_construct_id], which were returned by a previous call to /get_plot_data.

Returns JSON with items:

- **column_headers**: Array of the following strings labels (details about what these labels refer to is provided):
    - **"a_id"**: original identifier for compound "A" (left-hand-side compound of MMP), e.g. a ChEMBL number
    - **"a"**: SMILES for compound "A"
    - **"b_id"**: original identifier for compound "B" (right-hand-side compound of MMP), e.g. a ChEMBL number
    - **"b"**: SMILES for compound "B"
    - **"constant"**: SMILES for the unchanging common substructure of both compounds in the MMP, i.e. the portion of the MMP compounds' structures that is not affected by the transform
    - **label with the form a_property_name, depending on property name**: property value for compound A
    - **label with the form b_property_name, depending on property name**: property value for compound B
    - **label with the form property_name + "_" + change_type**: either a fold-change, or delta, of B's property value relative to A's property value
- **rows**: array of arrays (i.e., rows) with elements matching the above column headers, one row per MMP

## Request body

- PairsCondensed
  - `prop_changes` PairPropChange[], required
    - `property_name` string, required
    - `change_type` 'fold_change' | 'delta', required
    - `base` 'raw' | 'log'
    - `units` 'uM' | 'M'
  - `construct_id_pairs` array[], required
    - integer[]

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/merck/apis/matcher-backend.md) · [All operations](https://skmtc.dev/merck/apis/matcher-backend/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/merck/matcher-backend/revisions/59028f512f31/schema)