---
title: "List Banned Words"
method: GET
path: "/api/banned-words"
tags: ["Banned Words"]
---

# List Banned Words

`GET /api/banned-words`

## Request

- Base URL: `https://app.onlyfansapi.com`
- URL: `https://app.onlyfansapi.com/api/banned-words`
- Auth: HTTP bearer

Get a paginated, filterable list of the OnlyFans banned words OFAPI screens against. Use the `risk_level` values (`strict_ban`, `risky`, `replace_soften`) with the `blockBannedWords` parameter on the send/edit message, post, and mass-message endpoints.

## Query parameters

- `category` string, nullable: Filter by exact category, e.g. "Non-consensual acts". Must not be greater than 255 characters.
- `risk_level` 'strict_ban' | 'risky' | 'replace_soften', nullable: Filter by risk level: `strict_ban`, `risky`, or `replace_soften`.
- `search` string, nullable: Search within the word or its base form. Must not be greater than 255 characters.
- `per_page` integer: Number of words to return per page (1-100, default 50). Must be at least 1. Must not be greater than 100.

## Response `200`

Success

- object
  - `data` object[]
    - `word` string
    - `base` string
    - `category` string
    - `risk_level` string
    - `safe_alternatives` string
    - `notes` string, nullable
    - `regex_pattern` string
  - `links` object
    - `first` string
    - `last` string
    - `prev` string, nullable
    - `next` string
  - `meta` object
    - `current_page` integer
    - `from` integer
    - `last_page` integer
    - `path` string
    - `per_page` integer
    - `to` integer
    - `total` integer

## Changes

- **2026-10-17** `b3968f1bc1f0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/onlyfansapi/apis/onlyfans-api/changes/api/banned-words/get.md)

---

[API](https://skmtc.dev/onlyfansapi/apis/onlyfans-api.md) - [All operations](https://skmtc.dev/onlyfansapi/apis/onlyfans-api/llms.txt) - [OpenAPI document](https://skmtc.dev/onlyfansapi/apis/onlyfans-api/revisions/122c36386896?raw)