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

<Info>
  **Required scopes:** `candidates:read`<br />
  **Rate limit:** `default` tier, 120 requests per minute per key
</Info>

The calling recruiter's own Parascribe calls that have a transcript, newest first. Only calls you recorded are returned; teammates' calls are not, and there is no parameter for reading another recruiter's calls, so never ask the user for an id.

Each row is metadata only, so you can pick the right call: title, time, duration, calendar participants, the linked candidate and role when the call has one, and a short `summary` preview when one was generated. Rows carry no transcript text. To read what was said, pass the row's `callId` to `getParascribeCall`. Do not guess what was said from the title or summary.

`candidate.candidateId` is the id `getRecruiterCandidate` takes. A page holds at most 50 calls (`limit`, default 20). Pass `nextCursor` back as `cursor` for the next page.

## Query parameters

<ParamField query="cursor" type="integer | null" default={"0"}>
  Constraints: minimum 0.
</ParamField>

<ParamField query="limit" type="integer" default={"20"}>
  Constraints: minimum 1.
</ParamField>

## Response

<ResponseField name="calls" type="object[]" required>
  <Expandable title="calls properties">
    <ResponseField name="callId" type="string" required />

    <ResponseField name="title" type="string" required />

    <ResponseField name="scheduledAt" type="string" required />

    <ResponseField name="platform" type="string" required />

    <ResponseField name="durationSeconds" type="number | null" required />

    <ResponseField name="participants" type="object[]" required>
      <Expandable title="participants properties">
        <ResponseField name="name" type="string | null" required />

        <ResponseField name="email" type="string" required />
      </Expandable>
    </ResponseField>

    <ResponseField name="candidate" type="object | null" required>
      <Expandable title="candidate properties">
        <ResponseField name="candidateId" type="string" required />

        <ResponseField name="name" type="string" required />
      </Expandable>
    </ResponseField>

    <ResponseField name="role" type="object | null" required>
      <Expandable title="role properties">
        <ResponseField name="roleId" type="string" required />

        <ResponseField name="name" type="string" required />

        <ResponseField name="companyName" type="string" required />

        <ResponseField name="confidentialSearch" type="boolean" required />

        <ResponseField name="anonymizedName" type="string | null" required />

        <ResponseField name="urls" type="object" required>
          <Expandable title="urls properties">
            <ResponseField name="browse" type="string" required />

            <ResponseField name="recruit" type="string | null" required />
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="summary" type="string | null" required />

    <ResponseField name="url" type="string" required />
  </Expandable>
</ResponseField>

<ResponseField name="nextCursor" type="number" />

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://external-api.paraform.com/api/external/v1/recruiter/parascribe-calls?cursor=0&limit=20" \
    -H "Authorization: Bearer $PARAFORM_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "calls": [
      {
        "callId": "string",
        "title": "string",
        "scheduledAt": "string",
        "platform": "string",
        "durationSeconds": 0,
        "participants": [
          {}
        ],
        "candidate": {
          "candidateId": "string",
          "name": "string"
        },
        "role": {
          "roleId": "string",
          "name": "string",
          "companyName": "string",
          "confidentialSearch": true,
          "anonymizedName": "string",
          "urls": {}
        },
        "summary": "string",
        "url": "string"
      }
    ]
  }
  ```
</ResponseExample>


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