> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onlyfansapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Banned Words (/api-reference/banned-words/list-banned-words)

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.

## OpenAPI

````yaml https://app.onlyfansapi.com/scribe-docs/openapi.yaml get /api/banned-words
openapi: 3.0.3
info:
  title: OnlyFans API
  description: ""
  version: 1.0.0
servers:
  - url: https://app.onlyfansapi.com
security:
  - default: []
tags:
  - name: API Keys
    description: ""
  - name: Account
    description: Endpoints for your linked accounts
  - name: Analytics - Financial
    description: APIs for retrieving financial analytics data
  - name: Analytics - Summary
    description: APIs for retrieving summary analytics data
  - name: Banking
    description: Operations related to user banking details, payout methods, legal
      and tax information, and account country settings.
  - name: Banned Words
    description: Reference list of OnlyFans banned words used by the
      `blockBannedWords` screening parameter
  - name: Blocked / Restricted Users
    description: APIs for listing the users an account has blocked or restricted
  - name: Chargebacks
    description: ""
  - name: Chat Messages
    description: ""
  - name: Chats
    description: ""
  - name: Client Sessions
    description: ""
  - name: Connect OnlyFans Account
    description: ""
  - name: Data Exports
    description: APIs for managing data exports
  - name: Engagement / Messages
    description: ""
  - name: Fans
    description: APIs for managing OnlyFans fans (subscribers)
  - name: Fans - AI Summary
    description: APIs for generating and retrieving AI-powered fan profile summaries
  - name: Following
    description: APIs for managing OnlyFans followings (people you're subscribed to)
  - name: Free Trial Links
    description: APIs for managing Free Trial Links
  - name: Giphy
    description: ""
  - name: Link Tags
    description: APIs for managing tags on free trial links, tracking links, and Smart Links
  - name: Mass Messaging
    description: ""
  - name: Media
    description: ""
  - name: Media Vault
    description: ""
  - name: Media Vault Lists
    description: ""
  - name: Notifications
    description: Endpoints for managingr account notifications
  - name: Payouts
    description: ""
  - name: Post Comments
    description: ""
  - name: Post Labels
    description: APIs for managing your post labels
  - name: Posts
    description: APIs for managing OnlyFans posts
  - name: Promotions
    description: ""
  - name: Public Profiles
    description: ""
  - name: Queue
    description: ""
  - name: Release Forms
    description: APIs for managing OnlyFans release forms
  - name: Saved For Later (Messages)
    description: ""
  - name: Saved For Later (Posts)
    description: ""
  - name: Settings
    description: ""
  - name: Shared Free Trial Links
    description: APIs for Free Trial Links that other OF creators have shared with
      this account. Revenue, cost, and spender data are not available for shared
      links.
  - name: Shared Tracking Links
    description: APIs for Tracking Links (campaigns) that other OF creators have
      shared with this account. Revenue, cost, and spender data are not
      available for shared campaigns.
  - name: Smart Link Postbacks
    description: APIs for managing Smart Link postback destinations
  - name: Smart Links
    description: APIs for managing Smart Links (Free Trial Links and Tracking Links
      with pooled inventory)
  - name: Statistics
    description: ""
  - name: Stored Free Trial Links
    description: Instant APIs for retrieving stored free trial links from the
      OnlyFansAPI Cache (free, no credits used)
  - name: Stored Shared Free Trial Links
    description: Instant APIs for retrieving stored shared Free Trial Links from the
      OnlyFansAPI Cache (free, no credits used)
  - name: Stored Shared Tracking Links
    description: Instant APIs for retrieving stored shared Tracking Links
      (campaigns) from the OnlyFansAPI Cache (free, no credits used)
  - name: Stored Tracking Links
    description: Instant APIs for retrieving stored tracking links from the
      OnlyFansAPI Cache (free, no credits used)
  - name: Stories
    description: APIs for managing OnlyFans stories
  - name: Story Highlights
    description: APIs for managing OnlyFans story highlights
  - name: Subscription Bundles
    description: ""
  - name: Tracking Links
    description: APIs for managing tracking links
  - name: Transactions
    description: APIs for managing OnlyFans transactions
  - name: User List Collections
    description: ""
  - name: Users
    description: APIs for fetching OnlyFans users
  - name: Webhooks
    description: ""
paths:
  /api/banned-words:
    get:
      summary: List Banned Words
      operationId: listBannedWords
      description: 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.
      parameters:
        - in: query
          name: category
          description: Filter by exact category, e.g. "Non-consensual acts". Must not be
            greater than 255 characters.
          example: null
          required: false
          schema:
            type: string
            description: Filter by exact category, e.g. "Non-consensual acts". Must not be
              greater than 255 characters.
            example: null
            nullable: true
        - in: query
          name: risk_level
          description: "Filter by risk level: `strict_ban`, `risky`, or `replace_soften`."
          example: strict_ban
          required: false
          schema:
            type: string
            description: "Filter by risk level: `strict_ban`, `risky`, or `replace_soften`."
            example: strict_ban
            enum:
              - strict_ban
              - risky
              - replace_soften
            nullable: true
        - in: query
          name: search
          description: Search within the word or its base form. Must not be greater than
            255 characters.
          example: null
          required: false
          schema:
            type: string
            description: Search within the word or its base form. Must not be greater than
              255 characters.
            example: null
            nullable: true
        - in: query
          name: per_page
          description: Number of words to return per page (1-100, default 50). Must be at
            least 1. Must not be greater than 100.
          example: 50
          required: false
          schema:
            type: integer
            description: Number of words to return per page (1-100, default 50). Must be at
              least 1. Must not be greater than 100.
            example: 50
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                type: object
                example:
                  data:
                    - word: abduct
                      base: abduct
                      category: Non-consensual acts
                      risk_level: strict_ban
                      safe_alternatives: Avoid entirely. If needed, use “consensual roleplay,”
                        “fantasy scenario,” “dominant/submissive (consensual).”
                      notes: null
                      regex_pattern: "[aA@4][^a-zA-Z0-9_]{0,2}[bB8][^a-zA-Z0-9_]{0,2}[dD][^a-zA-Z0-9_\
                        ]{0,2}[uUvV][^a-zA-Z0-9_]{0,2}[cC\\(][^a-zA-Z0-9_]{0,2}\
                        [tT7+]"
                    - word: ballbusting
                      base: ballbusting
                      category: BDSM & fetish terms (violent/extreme)
                      risk_level: risky
                      safe_alternatives: Use “impact play (consensual),” “intense roleplay.”
                      notes: null
                      regex_pattern: null
                    - word: drink
                      base: drink
                      category: Substances/intoxication
                      risk_level: replace_soften
                      safe_alternatives: Use “relaxed,” “wind-down,” “chill night.”
                      notes: null
                      regex_pattern: null
                  links:
                    first: https://app.onlyfansapi.com/api/banned-words?page=1
                    last: https://app.onlyfansapi.com/api/banned-words?page=34
                    prev: null
                    next: https://app.onlyfansapi.com/api/banned-words?page=2
                  meta:
                    current_page: 1
                    from: 1
                    last_page: 34
                    path: https://app.onlyfansapi.com/api/banned-words
                    per_page: 50
                    to: 50
                    total: 1668
                properties:
                  data:
                    type: array
                    example:
                      - word: abduct
                        base: abduct
                        category: Non-consensual acts
                        risk_level: strict_ban
                        safe_alternatives: Avoid entirely. If needed, use “consensual roleplay,”
                          “fantasy scenario,” “dominant/submissive
                          (consensual).”
                        notes: null
                        regex_pattern: "[aA@4][^a-zA-Z0-9_]{0,2}[bB8][^a-zA-Z0-9_]{0,2}[dD][^a-zA-Z0-9_\
                          ]{0,2}[uUvV][^a-zA-Z0-9_]{0,2}[cC\\(][^a-zA-Z0-9_]{0,\
                          2}[tT7+]"
                      - word: ballbusting
                        base: ballbusting
                        category: BDSM & fetish terms (violent/extreme)
                        risk_level: risky
                        safe_alternatives: Use “impact play (consensual),” “intense roleplay.”
                        notes: null
                        regex_pattern: null
                      - word: drink
                        base: drink
                        category: Substances/intoxication
                        risk_level: replace_soften
                        safe_alternatives: Use “relaxed,” “wind-down,” “chill night.”
                        notes: null
                        regex_pattern: null
                    items:
                      type: object
                      properties:
                        word:
                          type: string
                          example: abduct
                        base:
                          type: string
                          example: abduct
                        category:
                          type: string
                          example: Non-consensual acts
                        risk_level:
                          type: string
                          example: strict_ban
                        safe_alternatives:
                          type: string
                          example: Avoid entirely. If needed, use “consensual roleplay,” “fantasy
                            scenario,” “dominant/submissive (consensual).”
                        notes:
                          type: string
                          example: null
                          nullable: true
                        regex_pattern:
                          type: string
                          example: "[aA@4][^a-zA-Z0-9_]{0,2}[bB8][^a-zA-Z0-9_]{0,2}[dD][^a-zA-Z0-9_]{0,2}\
                            [uUvV][^a-zA-Z0-9_]{0,2}[cC\\(][^a-zA-Z0-9_]{0,2}[t\
                            T7+]"
                  links:
                    type: object
                    properties:
                      first:
                        type: string
                        example: https://app.onlyfansapi.com/api/banned-words?page=1
                      last:
                        type: string
                        example: https://app.onlyfansapi.com/api/banned-words?page=34
                      prev:
                        type: string
                        example: null
                        nullable: true
                      next:
                        type: string
                        example: https://app.onlyfansapi.com/api/banned-words?page=2
                  meta:
                    type: object
                    properties:
                      current_page:
                        type: integer
                        example: 1
                      from:
                        type: integer
                        example: 1
                      last_page:
                        type: integer
                        example: 34
                      path:
                        type: string
                        example: https://app.onlyfansapi.com/api/banned-words
                      per_page:
                        type: integer
                        example: 50
                      to:
                        type: integer
                        example: 50
                      total:
                        type: integer
                        example: 1668
      tags:
        - Banned Words
components:
  securitySchemes:
    default:
      type: http
      scheme: bearer
      description: Get your API Key from OnlyFansAPI Console -
        https://app.onlyfansapi.com/api-keys
````