---
title: "List Call Pairing Previews"
method: GET
path: "/call-pairings/preview"
tags: ["call-pairings"]
---

# List Call Pairing Previews

`GET /call-pairings/preview`

## Request

- Base URL: `https://api.trytrata.com`
- URL: `https://api.trytrata.com/call-pairings/preview`
- Auth: HTTP bearer

## Query parameters

- `is_internal` boolean, nullable
- `statuses` CallPairingStatus[], nullable
- `is_first_call` boolean, nullable

## Response `200`

Successful Response

- CallPairingPreview[]
  - `num_pairs` integer, required
  - `num_priority_pairs` integer, required
  - `num_high_conviction_pairs` integer, required
  - `ticker` string, required
  - `pairs` CallPairingUserPreview[], required
    - `user1` PairingUser, required
      - `user_id` string, required
      - `name` string, required
      - `requested_ticker` string, nullable
      - `organization_name` string, nullable
      - `completed_calls` integer, nullable
      - `upcoming_calls` integer, nullable
      - `rescheduled_calls` integer, nullable
      - `cancelled_calls` integer, nullable
      - `last_call_date` string, date-time, nullable
      - `next_call_date` string, date-time, nullable
      - `calls_with_ticker` integer, nullable
      - `calls_with_paired_user` integer, nullable
      - `calls_with_ticker_and_paired_user` integer, nullable
      - `note` Note
        - `note_id` string, uuid, required
        - `text` string, nullable
      - `call_request_details` CallRequestDetails
        - `is_priority` boolean, required
        - `is_high_conviction` boolean, required
        - `depth` 'LIMITED' | 'MODERATE' | 'DEEP'
        - `position` 'NONE' | 'BEAR' | 'BULL' | 'SKEPTIC', required
      - `do_no_call` boolean
      - `is_block_other_user` boolean
      - `scores` UserScoreSnapshot
        - `call_quality` integer, nullable
        - `reliability` integer, nullable
    - `user2` PairingUser, required
      - `user_id` string, required
      - `name` string, required
      - `requested_ticker` string, nullable
      - `organization_name` string, nullable
      - `completed_calls` integer, nullable
      - `upcoming_calls` integer, nullable
      - `rescheduled_calls` integer, nullable
      - `cancelled_calls` integer, nullable
      - `last_call_date` string, date-time, nullable
      - `next_call_date` string, date-time, nullable
      - `calls_with_ticker` integer, nullable
      - `calls_with_paired_user` integer, nullable
      - `calls_with_ticker_and_paired_user` integer, nullable
      - `note` Note
        - `note_id` string, uuid, required
        - `text` string, nullable
      - `call_request_details` CallRequestDetails
        - `is_priority` boolean, required
        - `is_high_conviction` boolean, required
        - `depth` 'LIMITED' | 'MODERATE' | 'DEEP'
        - `position` 'NONE' | 'BEAR' | 'BULL' | 'SKEPTIC', required
      - `do_no_call` boolean
      - `is_block_other_user` boolean
      - `scores` UserScoreSnapshot
        - `call_quality` integer, nullable
        - `reliability` integer, nullable
    - `is_priority` boolean
    - `is_high_conviction` boolean
    - `is_blocked` boolean

## Other responses

- `404`: Not found
- `422`: Validation Error

## Changes

- **2026-10-06** `7c8c6b487ee1`: 2 breaking
  - removed the required property `items/pairs/items/user1/call_request_details/anyOf[subschema #1: CallRequestDetails]/familiarity` from the response with the `200` status
  - removed the required property `items/pairs/items/user2/call_request_details/anyOf[subschema #1: CallRequestDetails]/familiarity` from the response with the `200` status
- **2026-10-02** `118b3bb8f2ef`: 4 info
  - added the optional property `items/pairs/items/user1/call_request_details/anyOf[subschema #1: CallRequestDetails]/depth` to the response with the `200` status
  - added the optional property `items/pairs/items/user2/call_request_details/anyOf[subschema #1: CallRequestDetails]/depth` to the response with the `200` status
  - response property `items/pairs/items/user1/call_request_details/anyOf[subschema #1: CallRequestDetails]/familiarity` deprecated
  - response property `items/pairs/items/user2/call_request_details/anyOf[subschema #1: CallRequestDetails]/familiarity` deprecated
- **2026-09-09** `8a38d3a2ed97`: 2 info
  - added the optional property `items/pairs/items/user1/scores` to the response with the `200` status
  - added the optional property `items/pairs/items/user2/scores` to the response with the `200` status

[Operation history](https://skmtc.dev/trytrata/apis/trytrata-api/changes/call-pairings/preview/get.md)

---

[API](https://skmtc.dev/trytrata/apis/trytrata-api.md) - [All operations](https://skmtc.dev/trytrata/apis/trytrata-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trytrata/apis/trytrata-api/revisions/a6a3d5ff6ed0?raw)