Contacts API — List and Retrieve Prospect Contact Records

Contacts in Revont represent the prospects your team speaks with. Revont creates a contact record automatically the first time it identifies a new prospect on a call — typically by reading the email address from the calendar invite. Each contact accumulates a history of all calls where they appeared, making it easy to track engagement over time. Use the Contacts API to list all known prospects, look up individual contact records, and retrieve associated call history. This is particularly useful for syncing Revont’s contact data with your CRM or building per-account reporting.

List all contacts

GET /contacts

Returns a paginated list of all contacts in your workspace, ordered by creation time descending.

cURL

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

Query Parameters

integer

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

string

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

string

Filter results to the contact with this exact email address. Returns at most one result.

Response

{
  "data": [
    {
      "id": "contact_01HX7ABCDE",
      "email": "jane.doe@acme.com",
      "name": "Jane Doe",
      "company": "Acme Corp",
      "call_count": 4,
      "last_call_at": "2024-03-15T14:32:00Z",
      "created_at": "2024-01-08T09:14:00Z"
    },
    {
      "id": "contact_01HX7ABCDF",
      "email": "bob.smith@globex.com",
      "name": "Bob Smith",
      "company": "Globex",
      "call_count": 1,
      "last_call_at": "2024-03-14T10:15:00Z",
      "created_at": "2024-03-14T10:15:00Z"
    }
  ],
  "next_cursor": "cur_01HX7GHIJ",
  "has_more": true
}

Response Fields

array

Array of contact objects.

Show Contact object fields

string

Unique identifier for the contact.

string

The prospect’s email address.

string

The prospect’s full name, if available.

string

The prospect’s company name, if available.

integer

Total number of calls in your workspace where this contact appeared.

string

ISO 8601 timestamp of the most recent call involving this contact.

string

ISO 8601 timestamp indicating when this contact was first created in Revont.

string | null

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

boolean

true if additional contacts exist beyond the current page.

Retrieve a contact

GET /contacts/{id}

Returns a single contact record and their full call history within your workspace.

cURL

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

Path Parameters

string

required

The unique ID of the contact to retrieve.

Response

{
  "id": "contact_01HX7ABCDE",
  "email": "jane.doe@acme.com",
  "name": "Jane Doe",
  "company": "Acme Corp",
  "call_count": 4,
  "last_call_at": "2024-03-15T14:32:00Z",
  "created_at": "2024-01-08T09:14:00Z",
  "calls": [
    {
      "id": "call_01HX4BQZPK8J2NFRT3WY",
      "created_at": "2024-03-15T14:32:00Z",
      "duration_seconds": 1842,
      "coaching_score": 78,
      "outcome": "won"
    },
    {
      "id": "call_01HX2MNPQRS",
      "created_at": "2024-02-28T11:00:00Z",
      "duration_seconds": 2103,
      "coaching_score": 65,
      "outcome": "follow_up"
    },
    {
      "id": "call_01HX1ABCXYZ",
      "created_at": "2024-02-05T16:45:00Z",
      "duration_seconds": 1205,
      "coaching_score": 70,
      "outcome": "follow_up"
    },
    {
      "id": "call_01HX0DEFGHI",
      "created_at": "2024-01-08T09:14:00Z",
      "duration_seconds": 876,
      "coaching_score": 55,
      "outcome": "no_outcome"
    }
  ]
}

Response Fields

The response includes all fields from the list endpoint, plus:

array

Abbreviated call history for this contact, ordered by created_at descending.

Show Call history entry fields

string

Unique identifier of the call. Pass this to the Calls or Summaries endpoints to retrieve full details.

string

ISO 8601 timestamp indicating when the call was recorded.

integer

Total call duration in seconds.

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.

Overview

Endpoints

Contacts API — List and Retrieve Prospect Contact Records

List all contacts

Query Parameters

Response

Response Fields

Retrieve a contact

Path Parameters

Response

Response Fields

​List all contacts

​Query Parameters

​Response

​Response Fields

​Retrieve a contact

​Path Parameters

​Response

​Response Fields

List all contacts

Query Parameters

Response

Response Fields

Retrieve a contact

Path Parameters

Response

Response Fields