Skip to main content
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

​
limit
integer
Number of call records to return per page. Maximum 100, default 20.
​
cursor
string
Pagination cursor returned as next_cursor in a previous response. Omit this parameter to start from the beginning.
​
rep_id
string
Filter results to calls belonging to a specific rep. Pass the rep’s user ID.
​
from
string
Return only calls created on or after this ISO 8601 timestamp (e.g., 2024-01-01T00:00:00Z).
​
to
string
Return only calls created on or before this ISO 8601 timestamp (e.g., 2024-03-31T23:59:59Z).
​
outcome
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

​
data
array
Array of call objects for the current page.
​
next_cursor
string | null
Opaque cursor to pass as the cursor query parameter in your next request. null when there are no further pages.
​
has_more
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

​
id
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:
​
transcript
array
Ordered array of transcript segments representing the full conversation.