# Ringover Calls API

**Canonical:** https://apis.io/apis/ringover/ringover-calls-api/  
**Provider:** Ringover — https://apis.io/providers/ringover/  
**Base URL:** https://public-api.ringover.com/v2  
**Documentation:** https://developer.ringover.com/

Ringover Calls API is one of 28 APIs that [Ringover](https://apis.io/providers/ringover/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include calls. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Manage your Ringover call history. Retrieve terminated and current calls, apply filters (by date, type, tags, users, IVRs…), archive calls, and access survey results. **Permissions required:** - **Read** (`Calls R`): List and retrieve calls, get current calls, get survey answers. - **Write** (`Calls W`): Archive calls, initiate callbacks, control live calls (mute, hold, transfer, hangup, record, DTMF). **Monitoring impact — Read operations (listing):** > **Important:** Call listing routes (`GET /calls`, `POST /calls`, `GET /calls/{callId}`) always return **all team calls** regardless of the Monitoring flag. The Monitoring setting is not applied to call listing — these routes behave identically whether Monitoring is ON or OFF. **Monitoring impact — Write operations:** - *OFF*: Archive operations apply only to **your own calls**. Live call controls (`/channels/*/events/*`) and call recording access are **blocked** (`401`). - *ON*: Archive operations can target **any team call**. Live call controls and call recording access are unlocked. **Limitations:** - Date range is limited to **15 days** maximum per request. - `limit_count` maximum is **1000**, `limit_offset` maximum is **9000**. - Multiple items in the call list may share the same `call_id` (occurs with transfers or IVR routing). **Summary and transcription:** `summary` is the Ringover summary stored for the call (plain text). `transcription` is the call transcription (speeches and words). These are not Empower recaps. Download URLs are never returned. A field is in one of three states: - **omitted** — not requested - **`null`** — requested, and the call has no summary or transcription row - **object** — the row exists. If the file cannot be downloaded, the HTTP status stays `200` and the object sets `error.code` (`unavailable` when the download fails, `error` or `invalid` when the provider status is not usable). `summary.text` is then `null`. Where they are included: - `GET /calls` and `POST /calls` — only when the query parameter `expand` is `summary` and/or `transcription`. Repeat it to ask for both (`expand=summary&expand=transcription`). Each value downloads a file and adds latency. `contact` is always returned and is not an `expand` value. - `GET /calls/{callId}` — `summary`, `transcription` and `contact` are included on every log. There is no `expand` parameter. - MCP `calls.search` and `calls.get` — only the values passed in `expand` (`summary`, `transcription`, `contact`). Nothing is included by default, including `contact`.

## Operations (9)

| Method | Path | Summary |
|---|---|---|
| GET | `/calls` | List terminated calls |
| POST | `/calls` | List terminated calls with advanced filters |
| GET | `/calls/{callId}` | Get a specific call by ID |
| DELETE | `/calls/{callId}` | Archive a call by call ID |
| GET | `/calls/{callId}/channels/{channelId}` | Get call recording for a specific channel |
| DELETE | `/calls/{callId}/channels/{channelId}` | Archive a specific call channel |
| GET | `/calls/{callId}/surveys` | Get survey answers for a call |
| POST | `/calls/current` | List current (live) calls |
| DELETE | `/log` | Archive call logs |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/ringover/openapi/ringover-calls-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/ringover/json-schema/ringover-calls-filter-schema.json
- **JSONSchema** — https://artifacts.apis.io/ringover/json-schema/ringover-empower-logs-calls-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/ringover/json-schema/ringover-empower-logs-calls-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/ringover/json-schema/ringover-call-empower-schema.json
- **JSONSchema** — https://artifacts.apis.io/ringover/json-schema/ringover-conversation-light-schema.json
- **JSONSchema** — https://artifacts.apis.io/ringover/json-schema/ringover-get-call-empower-res-body-schema.json

## Other Ringover APIs (12)

- [Ringover Blacklist API](https://apis.io/apis/ringover/ringover-blacklist-api/)
- [Ringover Callbacks API](https://apis.io/apis/ringover/ringover-callbacks-api/)
- [Ringover Campaigns API](https://apis.io/apis/ringover/ringover-campaigns-api/)
- [Ringover Cdn API](https://apis.io/apis/ringover/ringover-cdn-api/)
- [Ringover Channels API](https://apis.io/apis/ringover/ringover-channels-api/)
- [Ringover Conferences API](https://apis.io/apis/ringover/ringover-conferences-api/)
- [Ringover Contacts API](https://apis.io/apis/ringover/ringover-contacts-api/)
- [Ringover Conversations API](https://apis.io/apis/ringover/ringover-conversations-api/)
- [Ringover Empower API](https://apis.io/apis/ringover/ringover-empower-api/)
- [Ringover Groups API](https://apis.io/apis/ringover/ringover-groups-api/)
- [Ringover Ivrs API](https://apis.io/apis/ringover/ringover-ivrs-api/)
- [Ringover MCP API](https://apis.io/apis/ringover/ringover-mcp-api/)

## Tags

calls

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/ringover/ringover-calls-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/ringover/.