# Ringover Blacklist API

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

Ringover Blacklist 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 blacklist. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Manage blacklisted phone numbers. There are two levels of blacklist: - **Team blacklist** (`/blacklists/numbers`): Blocks numbers for the entire team. Requires `Numbers R/W` + Monitoring ON. - **User blacklist** (`/users/{userId}/blacklists/numbers`): Blocks numbers for a specific user. Requires `Users R/W`. **Monitoring impact:** - *OFF*: Team blacklist routes are **blocked** (`401`). User blacklist routes work only for your own blacklist. - *ON*: Full team blacklist management. User blacklist routes can target any team member.

## Operations (10)

| Method | Path | Summary |
|---|---|---|
| GET | `/blacklists/numbers` | List team-wide blacklisted numbers |
| POST | `/blacklists/numbers` | Add a number to the team blacklist |
| GET | `/blacklists/numbers/{phoneNumber}` | Check if a number is in the team blacklist |
| DELETE | `/blacklists/numbers/{phoneNumber}` | Remove a number from the team blacklist |
| PATCH | `/blacklists/numbers/{phoneNumber}/comment/{newComment}` | Update the comment on a team blacklisted number |
| GET | `/users/{userId}/blacklists/numbers` | Get a user's personal blacklist |
| POST | `/users/{userId}/blacklists/numbers` | Add a number to a user's blacklist |
| GET | `/users/{userId}/blacklists/numbers/{phoneNumber}` | Check if a number is in a user's blacklist |
| DELETE | `/users/{userId}/blacklists/numbers/{phoneNumber}` | Remove a number from a user's blacklist |
| PATCH | `/users/{userId}/blacklists/numbers/{phoneNumber}/comment/{newComment}` | Update the comment on a user's blacklisted number |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/ringover/openapi/ringover-blacklist-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
- **APIsJSON** — https://artifacts.apis.io/ringover/apis.yml

## Other Ringover APIs (12)

- [Ringover Callbacks API](https://apis.io/apis/ringover/ringover-callbacks-api/)
- [Ringover Calls API](https://apis.io/apis/ringover/ringover-calls-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

blacklist

---

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