---
title: "Get a user's personal blacklist"
method: GET
path: "/users/{userId}/blacklists/numbers"
tags: ["blacklist"]
---

# Get a user's personal blacklist

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

Retrieves the phone numbers blacklisted by a specific user. A user's personal blacklist contains numbers that are blocked from calling or being called by this user specifically. This is distinct from the team-level blacklist (`GET /blacklists/numbers`). Results are paginated using `limit_count` and `limit_offset`.

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

**Monitoring impact:**
- **OFF:** Returns the blacklist only if `userId` matches **your own** user ID. Requesting another user's blacklist returns `401`.
- **ON:** Returns **any user's** personal blacklist.

## Path parameters

- `userId` integer, required

## Query parameters

- `limit_count` integer
- `limit_offset` integer

## Response `200`

Successful operation

- BlacklistList
  - `team_id` integer — Your team identifier
  - `limit_offset_setted` integer — Number of elements that will be ignored (default: 0).
  - `limit_count_setted` integer — The number of results (default: 100).
  - `total_blacklist_count` integer — The total number of blacklisted phone numbers
  - `blacklist_list_count` integer — The size of the array <em>blacklist_list</em>, corresponds to the number of blacklisted phone numbers retrieved.
  - `blacklist_list` 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

- `204` — The user's blacklist is empty
- `400` — The provided user ID is invalid
- `401` — Authentication token is missing, invalid, expired, or Users Read permission is missing
- `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)