Skip to main content
POST
/
blacklists
Blacklist an IP address
curl --request POST \
  --url https://api.mclicense.org/blacklists \
  --header 'Content-Type: application/json' \
  --header 'MCL-Key: <api-key>' \
  --data '
{
  "ip": "<string>",
  "reason": "<string>"
}
'
{
  "ip": "<string>",
  "_id": "<string>",
  "reason": "<string>",
  "createdAt": "2023-11-07T05:31:56Z"
}

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.

Authorizations

​
MCL-Key
string
header
required

API key must start with 'mcl_'

Body

application/json
​
ip
string
required

IPv4 address to blacklist

​
reason
string

Optional reason for blacklisting

Response

201 - application/json

Blacklist entry created

​
ip
string
required

Blacklisted IPv4 address

​
_id
string
read-only

Unique identifier for the blacklist entry

​
reason
string

Optional reason for blacklisting

​
createdAt
string<date-time>
read-only

Timestamp when the entry was created