---
title: "Check if a number is in a user's blacklist"
method: GET
path: "/users/{userId}/blacklists/numbers/{phoneNumber}"
tags: ["blacklist"]
---

# Check if a number is in a user's blacklist

`GET /users/{userId}/blacklists/numbers/{phoneNumber}`

Checks whether a specific phone number is present in a user's personal blacklist. Returns `200` with the blacklist entry (including comment) if the number is found, or `404` if it is not blacklisted. Use this for quick lookups before deciding to add or remove a number.

**Permission:** `Users Read` required.

**Monitoring impact:**
- **OFF:** Can only check **your own** blacklist. Requesting another user's blacklist returns `401`.
- **ON:** Can check **any user's** blacklist.

## Path parameters

- `userId` integer, required
- `phoneNumber` integer, required

## Response `200`

The phone number is blacklisted by this user

- Blacklist
  - `user_id` integer — Your user identifier
  - `team_id` integer — Your team identifier
  - `number` integer — A blacklisted number
  - `comment` string, nullable — The comment about this blacklisted number, can be null.
  - `direction` string — IN or OUT for blacklisted numbers (direction of the call)

## Other responses

- `400` — The provided user ID or phone number is invalid
- `401` — Authentication token is missing, invalid, expired, or Users Read permission is missing
- `404` — The phone number is not in the user's blacklist
- `500` — Internal server error

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)