> ## Documentation Index
> Fetch the complete documentation index at: https://docs.revont.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Summaries API — AI Call Summaries and Action Items

> Retrieve AI-generated summaries and extracted action items for completed calls via the Revont REST API. Includes key moments, objections, and next steps.

After each call ends, Revont's AI engine automatically analyzes the transcript and produces a structured summary — covering a narrative overview, key moments, objections and responses, decisions made, and next steps. It also extracts discrete action items assigned to the rep or the prospect. Use these endpoints to pull that structured data into your own systems, CRM, or reporting tools.

***

## Get a call summary

```
GET /calls/{id}/summary
```

Returns the AI-generated summary for a completed call. The summary is typically available within a few minutes of the call ending.

```bash cURL theme={null}
curl "https://api.revont.ai/v1/calls/call_01HX4BQZPK8J2NFRT3WY/summary" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Path Parameters

<ParamField path="id" type="string" required>
  The unique ID of the call whose summary you want to retrieve.
</ParamField>

### Response

```json theme={null}
{
  "call_id": "call_01HX4BQZPK8J2NFRT3WY",
  "overview": "Jane Doe from Acme explored Revont's coaching analytics features during a 30-minute product demo. The rep walked through the dashboard, scoring breakdowns, and CRM sync capabilities. Jane expressed strong interest in the Enterprise plan and raised a concern about onboarding timelines. The call ended with an agreed next step to send a custom proposal by Friday.",
  "key_moments": [
    {
      "timestamp_ms": 145000,
      "description": "Rep demonstrated the coaching score breakdown feature, prompting positive engagement from the prospect."
    },
    {
      "timestamp_ms": 782000,
      "description": "Prospect raised an objection about the length of the onboarding process."
    },
    {
      "timestamp_ms": 1710000,
      "description": "Both parties agreed on a follow-up proposal to be sent by Friday."
    }
  ],
  "objections": [
    {
      "objection": "We're worried the onboarding will take too long and distract the team.",
      "response": "Rep explained the standard onboarding is two weeks with a dedicated success manager and offered to share a customer case study."
    }
  ],
  "decisions": [
    "Prospect will loop in their VP of Sales for the next call.",
    "Rep will prepare a custom Enterprise pricing proposal."
  ],
  "next_steps": [
    "Rep to send custom proposal to jane.doe@acme.com by Friday, March 22.",
    "Schedule a follow-up call with Acme's VP of Sales within two weeks."
  ],
  "coaching_score": 78,
  "generated_at": "2024-03-15T15:01:22Z"
}
```

### Response Fields

<ResponseField name="call_id" type="string">
  The ID of the call this summary belongs to.
</ResponseField>

<ResponseField name="overview" type="string">
  A 2–4 sentence narrative summary of the call covering context, key discussion points, and outcome.
</ResponseField>

<ResponseField name="key_moments" type="array">
  An ordered array of significant moments identified in the call.

  <Expandable title="Key moment fields">
    <ResponseField name="timestamp_ms" type="integer">
      Position in the call where this moment occurred, in milliseconds from the start.
    </ResponseField>

    <ResponseField name="description" type="string">
      A short description of what happened at this moment.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="objections" type="array">
  Objections raised by the prospect and how the rep responded to each.

  <Expandable title="Objection fields">
    <ResponseField name="objection" type="string">
      The objection raised by the prospect, paraphrased from the transcript.
    </ResponseField>

    <ResponseField name="response" type="string">
      How the rep addressed the objection.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="decisions" type="array">
  List of strings describing decisions or agreements reached during the call.
</ResponseField>

<ResponseField name="next_steps" type="array">
  List of strings describing the agreed next steps at the end of the call.
</ResponseField>

<ResponseField name="coaching_score" type="integer">
  AI-generated coaching score for the call, from 0 (lowest) to 100 (highest).
</ResponseField>

<ResponseField name="generated_at" type="string">
  ISO 8601 timestamp indicating when this summary was generated by Revont.
</ResponseField>

***

## Get action items for a call

```
GET /calls/{id}/action-items
```

Returns the discrete action items Revont extracted from the call. Each item is assigned to either the rep or the prospect, and may include a due date.

```bash cURL theme={null}
curl "https://api.revont.ai/v1/calls/call_01HX4BQZPK8J2NFRT3WY/action-items" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Path Parameters

<ParamField path="id" type="string" required>
  The unique ID of the call whose action items you want to retrieve.
</ParamField>

### Response

```json theme={null}
{
  "data": [
    {
      "id": "ai_01HX5MNPQR",
      "description": "Send custom Enterprise pricing proposal to jane.doe@acme.com.",
      "owner": "rep",
      "due_date": "2024-03-22",
      "completed": false,
      "created_at": "2024-03-15T15:01:22Z"
    },
    {
      "id": "ai_01HX5MNPQS",
      "description": "Loop in VP of Sales for the follow-up call.",
      "owner": "prospect",
      "due_date": null,
      "completed": false,
      "created_at": "2024-03-15T15:01:22Z"
    }
  ]
}
```

### Response Fields

<ResponseField name="data" type="array">
  Array of action item objects extracted from the call.

  <Expandable title="Action item fields">
    <ResponseField name="id" type="string">
      Unique identifier for the action item.
    </ResponseField>

    <ResponseField name="description" type="string">
      A clear description of the action to be taken.
    </ResponseField>

    <ResponseField name="owner" type="string">
      Who is responsible for completing this action item. Either `rep` or `prospect`.
    </ResponseField>

    <ResponseField name="due_date" type="string | null">
      ISO 8601 date by which the action item should be completed. `null` if no due date was specified on the call.
    </ResponseField>

    <ResponseField name="completed" type="boolean">
      Whether the action item has been marked as completed.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp indicating when this action item was created.
    </ResponseField>
  </Expandable>
</ResponseField>