> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paraform.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List your recorded Parascribe calls

> Use to find your past recorded calls. Own calls only, never teammates'. Rows have no transcript: pass callId to getParascribeCall. query matches title, linked candidate name or attendee email, not summary or transcript. candidateId from listRecruiterCandidates.

Required scopes: `calls:read`.



## OpenAPI

````yaml /api/openapi.json get /recruiter/parascribe-calls
openapi: 3.0.0
info:
  title: Paraform API
  version: v1
servers:
  - url: https://external-api.paraform.com/api/external/v1
security: []
paths:
  /recruiter/parascribe-calls:
    get:
      summary: List your recorded Parascribe calls
      description: >-
        Use to find your past recorded calls. Own calls only, never teammates'.
        Rows have no transcript: pass callId to getParascribeCall. query matches
        title, linked candidate name or attendee email, not summary or
        transcript. candidateId from listRecruiterCandidates.


        Required scopes: `calls:read`.
      operationId: listParascribeCalls
      parameters:
        - schema:
            type: string
            minLength: 1
            description: >-
              Only calls linked to this candidate: `candidateId` of candidate
              row. Candidate with no calls with you returns empty list.
          required: false
          description: >-
            Only calls linked to this candidate: `candidateId` of candidate row.
            Candidate with no calls with you returns empty list.
          name: candidateId
          in: query
        - schema:
            type: string
            minLength: 1
            description: >-
              Only calls linked to this role id. Most calls have no linked role;
              prefer `candidateId` or `query`.
          required: false
          description: >-
            Only calls linked to this role id. Most calls have no linked role;
            prefer `candidateId` or `query`.
          name: roleId
          in: query
        - schema:
            type: string
            minLength: 1
            description: >-
              Case-insensitive text; must appear whole in call title or linked
              candidate's name, or match attendee email, e.g. `Jane`. Summaries
              and transcripts not searched.
          required: false
          description: >-
            Case-insensitive text; must appear whole in call title or linked
            candidate's name, or match attendee email, e.g. `Jane`. Summaries
            and transcripts not searched.
          name: query
          in: query
        - schema:
            type: string
            format: date-time
            description: >-
              Only calls scheduled at or after this ISO 8601 timestamp with
              timezone, e.g. `2026-10-01T00:00:00Z`. Must be before
              `scheduledBefore` (400 otherwise).
          required: false
          description: >-
            Only calls scheduled at or after this ISO 8601 timestamp with
            timezone, e.g. `2026-10-01T00:00:00Z`. Must be before
            `scheduledBefore` (400 otherwise).
          name: scheduledAfter
          in: query
        - schema:
            type: string
            format: date-time
            description: >-
              Only calls scheduled before this ISO 8601 timestamp with timezone,
              e.g. `2026-11-01T00:00:00Z`.
          required: false
          description: >-
            Only calls scheduled before this ISO 8601 timestamp with timezone,
            e.g. `2026-11-01T00:00:00Z`.
          name: scheduledBefore
          in: query
        - schema:
            type: integer
            nullable: true
            minimum: 0
            default: 0
            description: Previous page's `nextCursor`, same filters. Omit for first page.
          required: false
          description: Previous page's `nextCursor`, same filters. Omit for first page.
          name: cursor
          in: query
        - schema:
            type: integer
            minimum: 1
            default: 10
            description: Calls per page. Default 10; above 50 lowered to 50.
          required: false
          description: Calls per page. Default 10; above 50 lowered to 50.
          name: limit
          in: query
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  calls:
                    type: array
                    items:
                      type: object
                      properties:
                        callId:
                          type: string
                        title:
                          type: string
                        scheduledAt:
                          type: string
                          description: ISO 8601 scheduled time.
                        platform:
                          type: string
                          description: 'Call platform: GOOGLE_MEET, ZOOM, PHONE, etc.'
                        durationSeconds:
                          type: number
                          nullable: true
                          description: Null when transcript has no timestamps.
                        participants:
                          type: array
                          items:
                            type: object
                            properties:
                              name:
                                type: string
                            required:
                              - name
                          description: >-
                            Calendar invitees, name only. Empty for phone calls
                            and calls without invite.
                        candidate:
                          type: object
                          nullable: true
                          properties:
                            candidateId:
                              type: string
                            name:
                              type: string
                          required:
                            - candidateId
                            - name
                          description: Linked CRM candidate. Null for none.
                        role:
                          type: object
                          nullable: true
                          properties:
                            roleId:
                              type: string
                            name:
                              type: string
                            companyName:
                              type: string
                            confidentialSearch:
                              type: boolean
                              description: >-
                                True for confidential search: candidate-facing
                                copy uses `anonymizedName`, never `companyName`.
                            anonymizedName:
                              type: string
                              nullable: true
                            urls:
                              type: object
                              properties:
                                browse:
                                  type: string
                                recruit:
                                  type: string
                                  nullable: true
                              required:
                                - browse
                                - recruit
                              description: >-
                                `recruit` always null here; getRecruiterRole has
                                live recruit link.
                          required:
                            - roleId
                            - name
                            - companyName
                            - confidentialSearch
                            - anonymizedName
                            - urls
                          description: Linked role. Null for none.
                        summary:
                          type: string
                          nullable: true
                          description: >-
                            Call summary, cut to 600 characters on list rows.
                            Null when none generated.
                        url:
                          type: string
                          description: Call in Paraform app.
                      required:
                        - callId
                        - title
                        - scheduledAt
                        - platform
                        - durationSeconds
                        - participants
                        - candidate
                        - role
                        - summary
                        - url
                  nextCursor:
                    type: number
                    description: Absent on last page.
                required:
                  - calls
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.