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

# List Call Pairing Previews

`GET /call-pairings/preview`

## 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
        - `familiarity` 'NOT_WELL' | 'SOMEWHAT' | 'VERY_WELL', required
        - `position` 'NONE' | 'BEAR' | 'BULL' | 'SKEPTIC', required
      - `do_no_call` boolean
      - `is_block_other_user` boolean
    - `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
        - `familiarity` 'NOT_WELL' | 'SOMEWHAT' | 'VERY_WELL', required
        - `position` 'NONE' | 'BEAR' | 'BULL' | 'SKEPTIC', required
      - `do_no_call` boolean
      - `is_block_other_user` boolean
    - `is_priority` boolean
    - `is_high_conviction` boolean
    - `is_blocked` boolean

## Other responses

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

---

[API](https://skmtc.dev/trytrata/apis/fastapi.md) · [All operations](https://skmtc.dev/trytrata/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/trytrata/fastapi/revisions/a8ae8846c411/schema)