---
title: "List Recordings"
method: GET
path: "/recordings/"
tags: ["recordings"]
---

# List Recordings

`GET /recordings/`

## Query parameters

- `type` 'voice_agent' | 'voice_call', required
- `limit` integer
- `cursor` string, nullable

## Response `200`

Successful Response

- RecordingsResponse
  - `recordings` Recording[], required
    - `cloud_provider` 'daily', required
    - `type` 'voice_agent' | 'voice_call', required
    - `id` string, uuid, required
    - `name` string, required
    - `call_room_name` string, nullable
    - `duration` integer, nullable, required
    - `last_modified` string, date-time, required
    - `is_internal` boolean, nullable
    - `google_document_url` string, nullable
    - `google_document_urls` string[]
    - `raw_google_document_url` string, nullable
    - `contentful_transcript_urls` string[]
    - `contentful_transcript_ids` string[]
    - `task_runs` TaskRunResponse[]
      - `task_run_id` string, required
      - `task_name` string, required
      - `status` 'NOT_STARTED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED', required
      - `started_at` string, date-time, nullable
      - `completed_at` string, date-time, nullable
      - `details` object
    - `agent_user` RecordingUser
      - `user_id` string, required
      - `first_name` string, nullable
      - `last_name` string, nullable
      - `internal_role` 'ADMIN' | 'TEST' | 'REVIEWER' | 'LEAD_REVIEWER'
    - `call_id` string, uuid, nullable
    - `participants` AdminParticipant[]
      - `association_id` string, uuid, required
      - `user_id` string, nullable
      - `guest_id` string, uuid, nullable
      - `guest_name` string, nullable
      - `guest_email` string, nullable
      - `role` 'PRIMARY' | 'SECONDARY' | 'GUEST', required
      - `first_name` string, nullable
      - `last_name` string, nullable
      - `note` Note
        - `note_id` string, uuid, required
        - `text` string, nullable
      - `user_note` string, nullable
      - `is_first_call` boolean, nullable
      - `status` 'PENDING' | 'CONFIRMED' | 'DECLINED'
      - `updated_at` string, date-time, nullable
      - `last_calendar_update` string, date-time, nullable
      - `analyst_call_name` string, nullable
      - `association_source_id` string, uuid, nullable
      - `call_request_history` AdminParticipantCallRequestHistory
        - `status` 'OPEN' | 'PAUSED' | 'CLOSED', required
        - `familiarity` 'NOT_WELL' | 'SOMEWHAT' | 'VERY_WELL', required
        - `position` 'NONE' | 'BEAR' | 'BULL' | 'SKEPTIC', required
        - `is_priority` boolean, required
        - `is_high_conviction` boolean, required
        - `notes` string, nullable
        - `is_open_for_multiple_calls` boolean, nullable
        - `call_ticker_lead_id` string, uuid, nullable
      - `call_ticker_lead` AdminParticipantCallTickerLead
        - `source` string, uuid, required
    - `session_id` string, nullable
    - `transcript_id` string, nullable
    - `ticker` string, nullable
    - `prompt_id` string, nullable
    - `status` 'PENDING' | 'RECORDING_PROCESSED' | 'TRANSCRIPT_REVIEW' | 'CONTENTFUL_REVIEW' | 'PUBLISHED' | 'CANCELLED'
    - `transcript_review_completed_count` integer
    - `transcript_review_total_count` integer
    - `transcript_review_owner_id` string, nullable
    - `note` Note
      - `note_id` string, uuid, required
      - `text` string, nullable
    - `user_recording_review` UserRecordingReview
      - `user_reviewers` UserBasic[]
        - `user_id` string, required
        - `first_name` string, nullable
        - `last_name` string, nullable
      - `organization_reviewers` OrganizationBasic[]
        - `organization_id` string, uuid, required
        - `name` string, required
        - `created_at` string, date-time, required
        - `num_members` integer
        - `active_member_count` integer
        - `representative` OrganizationRepresentative
          - `user_id` string, required
          - `name` string, required
          - `email` string, required
          - `deactivated` boolean
        - `pay_rate_usd` integer, nullable
        - `recording_review` boolean
        - `is_personal` boolean
        - `compliance_enabled` boolean
        - `fund_type` 'LONG_SHORT' | 'LONG_ONLY' | 'MARKET_NEUTRAL' | 'MULTI_STRATEGY'
        - `portfolio_style` 'CONCENTRATED' | 'DIVERSIFIED'
        - `time_horizon` 'SHORT_TERM' | 'MEDIUM_TERM' | 'LONG_TERM'
        - `subscription_status` 'INCOMPLETE' | 'INCOMPLETE_EXPIRED' | 'TRIALING' | 'ACTIVE' | 'PAST_DUE' | 'CANCELED' | 'UNPAID' | 'PAUSED'
        - `subscription_expires_at` string, date-time, nullable
        - `subscription_recurring` boolean, nullable
        - `renewal_terms_prepared` boolean
        - `subscription_terms_has_agreement` boolean
        - `subscription_terms_unsigned` boolean
        - `subscription_terms_signed_at` string, date-time, nullable
        - `subscription_terms_created_at` string, date-time, nullable
        - `note` Note
          - `note_id` string, uuid, required
          - `text` string, nullable
        - `deactivated` boolean
        - `has_open_invites` boolean
        - `latest_invoice` StripeInvoiceBasic
          - `id` string, required
          - `status` 'draft' | 'open' | 'paid' | 'void' | 'uncollectible'
          - `due_date` string, date-time, nullable
          - `amount_due_cents` integer
        - `latest_subscription` StripeSubscriptionBasic
          - `id` string, required
          - `status` 'active' | 'canceled' | 'incomplete' | 'incomplete_expired' | 'paused' | 'past_due' | 'trialing' | 'unpaid'
        - `product_trial_ends_at` string, date-time, nullable
  - `next_cursor` string, nullable, required

## 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)