Calls API — List and Retrieve Recorded Sales Calls

The Calls API gives you access to every call recorded in your Revont workspace. You can list calls with filters — by rep, date range, or outcome — and retrieve individual calls with their full transcripts and metadata. Use these endpoints to build reporting pipelines, feed data into your CRM, or power custom coaching dashboards.

List all calls

GET /calls

Returns a paginated list of call records in your workspace, ordered by creation time descending. Use the query parameters below to filter and page through results.

cURL

curl "https://api.revont.ai/v1/calls?limit=20&outcome=won" \
  -H "Authorization: Bearer YOUR_API_KEY"

Query Parameters

integer

Number of call records to return per page. Maximum 100, default 20.

string

Pagination cursor returned as next_cursor in a previous response. Omit this parameter to start from the beginning.

string

Filter results to calls belonging to a specific rep. Pass the rep’s user ID.

string

Return only calls created on or after this ISO 8601 timestamp (e.g., 2024-01-01T00:00:00Z).

string

Return only calls created on or before this ISO 8601 timestamp (e.g., 2024-03-31T23:59:59Z).

string

Filter by call outcome. Accepted values: won, lost, follow_up, no_outcome.

Response

{
  "data": [
    {
      "id": "call_01HX4BQZPK8J2NFRT3WY",
      "created_at": "2024-03-15T14:32:00Z",
      "duration_seconds": 1842,
      "rep_id": "user_01HX1ABCDE",
      "prospect_email": "jane.doe@acme.com",
      "coaching_score": 78,
      "outcome": "won"
    },
    {
      "id": "call_01HX4BQZPK8J2NFRT3WZ",
      "created_at": "2024-03-14T10:15:00Z",
      "duration_seconds": 934,
      "rep_id": "user_01HX1ABCDE",
      "prospect_email": "bob.smith@globex.com",
      "coaching_score": 61,
      "outcome": "follow_up"
    }
  ],
  "next_cursor": "cur_01HX4CDEF",
  "has_more": true
}

Response Fields

array

Array of call objects for the current page.

Show Call object fields

string

Unique identifier for the call.

string

ISO 8601 timestamp indicating when the call was recorded.

integer

Total call duration in seconds.

string

User ID of the sales rep on the call.

string

Email address of the prospect on the call, typically sourced from the calendar invite.

integer

AI-generated coaching score for this call, from 0 to 100.

string

Outcome of the call. One of won, lost, follow_up, or no_outcome.

string | null

Opaque cursor to pass as the cursor query parameter in your next request. null when there are no further pages.

boolean

true if additional records exist beyond the current page.

Retrieve a call

GET /calls/{id}

Returns a single call record by its ID, including the full transcript broken into speaker-labeled segments.

cURL

curl "https://api.revont.ai/v1/calls/call_01HX4BQZPK8J2NFRT3WY" \
  -H "Authorization: Bearer YOUR_API_KEY"

Path Parameters

string

required

The unique ID of the call to retrieve.

Response

{
  "id": "call_01HX4BQZPK8J2NFRT3WY",
  "created_at": "2024-03-15T14:32:00Z",
  "duration_seconds": 1842,
  "rep_id": "user_01HX1ABCDE",
  "prospect_email": "jane.doe@acme.com",
  "coaching_score": 78,
  "outcome": "won",
  "transcript": [
    {
      "speaker": "rep",
      "start_ms": 0,
      "end_ms": 7400,
      "text": "Hey Jane, thanks for making the time today. How are you doing?"
    },
    {
      "speaker": "prospect",
      "start_ms": 7500,
      "end_ms": 14200,
      "text": "Doing well, thanks! Really looking forward to seeing the new features."
    },
    {
      "speaker": "rep",
      "start_ms": 14300,
      "end_ms": 26800,
      "text": "Great — let me share my screen and we can jump right in."
    }
  ]
}

Response Fields

In addition to all fields returned by the list endpoint, the single-call response includes:

array

Ordered array of transcript segments representing the full conversation.

Show Transcript segment fields

string

Who spoke this segment. Either rep or prospect.

integer

Start time of the segment in milliseconds from the beginning of the call.

integer

End time of the segment in milliseconds from the beginning of the call.

string

Transcribed text of the segment.

Overview

Endpoints

Calls API — List and Retrieve Recorded Sales Calls

List all calls

Query Parameters

Response

Response Fields

Retrieve a call

Path Parameters

Response

Response Fields

​List all calls

​Query Parameters

​Response

​Response Fields

​Retrieve a call

​Path Parameters

​Response

​Response Fields

List all calls

Query Parameters

Response

Response Fields

Retrieve a call

Path Parameters

Response

Response Fields