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

# Parascribe calls

> List the calls you recorded with Parascribe and read their full transcripts.

Two endpoints give you the Parascribe calls **you** recorded. Both need a personal key with `candidates:read`. Teammates' calls are never returned, and there's no parameter for reading another recruiter's calls.

## List your calls

[`GET /recruiter/parascribe-calls`](/recruiter/api-reference/list-parascribe-calls) returns your calls that have a transcript, newest first.

```bash theme={null}
curl "https://external-api.paraform.com/api/external/v1/recruiter/parascribe-calls?limit=50" \
  -H "Authorization: Bearer $PARAFORM_API_KEY"
```

Each row is metadata only: `callId`, title, time, duration, calendar participants, the linked candidate and role when there is one, and a short `summary` preview when one was generated. Rows carry no transcript text.

Pages hold up to 50 calls (`limit`, default 20). Pass `nextCursor` back as `cursor` for the next page. See [Pagination](/pagination).

## Read one call's transcript

[`GET /recruiter/parascribe-calls/{callId}`](/recruiter/api-reference/get-parascribe-call) returns the same metadata, the full `summary`, and the whole `transcript` as speaker turns in call order.

```bash theme={null}
curl "https://external-api.paraform.com/api/external/v1/recruiter/parascribe-calls/$CALL_ID" \
  -H "Authorization: Bearer $PARAFORM_API_KEY"
```

Each transcript turn has:

* the speaker label
* start and end offsets, in seconds from the start of the recording
* the words spoken

Speaker labels come from the recording provider. They can be a name, an email, or a generic label such as `Speaker A`.

* Use a `callId` from the list. Never guess one.
* A call that doesn't exist, isn't yours, or has no transcript returns `404`.
* Transcripts are long, so fetch one call at a time instead of every call in a list.


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