Report and ban a new IP or set of IP addresses

POST {{baseUrl}}/v1/ip

Authentication

The API is protected by a Bearer authentication schema. Bearer authentication (also called token authentication) is an HTTP authentication scheme that involves security tokens called bearer tokens. It is used to authenticate the user. All the different endpoints expect a Bearer token in the Authorization header.

Example:

curl -X 'POST' \
  'https://REGION.report.threatjammer.com/test' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY'

You can obtain a token after registering on the ThreatJammer.com website for free.

The body of the request must be a JSON object with the following fields: - addresses: a list of IPv4 or IPv6 addresses to report. - ttl: [Optional] the time to live of the reported IP addresses in the database in seconds. Default 86400 seconds. - type: [Optional] the type of the reported IP addresses. It must be one the allowed datasets. Default ABUSE. - tags: [Optional] a list of the tags to tag the reported IP addresses. Default is empty.

The service returns a 202 response code if the request is accepted. Then, the service will process the request asynchronously sending the information to the abuse reporting engine as soon as possible. The response body is empty. The service will not return a 200 response code in any case. Assume 202 as the only valid response.

If the Bearer token is not valid, the service returns a 401 response code.

If the object passed in the body is not valid, the service returns a 422 response code. Please check the request format.

There is a limit of 6 hits per minute per token. If the limit is reached, the service returns a 429 response code.

Request Body

{"addresses"=>["eni"], "ttl"=>97734842, "type"=>"ea dolore", "tags"=>["3VM02G26V", "LB-OHIF1-Q-RNA050T990-JYRCK34-G1DBN-8FXM-4FOEYEOISS9-GIEIL-A2QYD-1S8T"]}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{}