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.
Returns a paginated list of all contacts in your workspace, ordered by creation time descending.
curl "https://api.revont.ai/v1/contacts?limit=20" \ -H "Authorization: Bearer YOUR_API_KEY"
Query Parameters Number of contacts to return per page. Maximum 100, default 20.
Pagination cursor returned as next_cursor in a previous response. Omit to start from the beginning.
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 of contact objects. Show Contact object fields
Unique identifier for the contact.
The prospect’s email address.
The prospect’s full name, if available.
The prospect’s company name, if available.
Total number of calls in your workspace where this contact appeared.
ISO 8601 timestamp of the most recent call involving this contact.
ISO 8601 timestamp indicating when this contact was first created in Revont.
Opaque cursor to pass as cursor in your next request. null when there are no further pages.
true if additional contacts exist beyond the current page.
Returns a single contact record and their full call history within your workspace.
curl "https://api.revont.ai/v1/contacts/contact_01HX7ABCDE" \ -H "Authorization: Bearer YOUR_API_KEY"
Path Parameters 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:
Abbreviated call history for this contact, ordered by created_at descending. Show Call history entry fields
Unique identifier of the call. Pass this to the Calls or Summaries endpoints to retrieve full details. ISO 8601 timestamp indicating when the call was recorded.
Total call duration in seconds.
AI-generated coaching score for this call, from 0 to 100.
Outcome of the call. One of won, lost, follow_up, or no_outcome.
