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

# Blacklist an IP

> Adds an IPv4 address to the blacklist, preventing it from validating any license on your account



## OpenAPI

````yaml POST /blacklists
openapi: 3.0.1
info:
  title: MC License API
  description: API for validating and managing Minecraft plugin licenses
  version: 1.0.0
  license:
    name: MIT
servers:
  - url: https://api.mclicense.org
    description: Production API Server
security:
  - apiKey: []
paths:
  /blacklists:
    post:
      summary: Blacklist an IP address
      description: >-
        Adds an IPv4 address to the blacklist, preventing it from validating any
        license on your account
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - ip
              properties:
                ip:
                  type: string
                  description: IPv4 address to blacklist
                reason:
                  type: string
                  description: Optional reason for blacklisting
      responses:
        '201':
          description: Blacklist entry created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Blacklist'
components:
  schemas:
    Blacklist:
      type: object
      required:
        - ip
      properties:
        _id:
          type: string
          readOnly: true
          description: Unique identifier for the blacklist entry
        ip:
          type: string
          description: Blacklisted IPv4 address
        reason:
          type: string
          description: Optional reason for blacklisting
        createdAt:
          type: string
          format: date-time
          readOnly: true
          description: Timestamp when the entry was created
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: MCL-Key
      description: API key must start with 'mcl_'

````