Logo

Docs

IP addresses [FLAT]

If you need a simple list (example CSV) to retreive all the IPv4 feeds based on their score, you can use the below API

GET Flat list of IPv4

You can call the API /api/v1/flat/:min_score in order to receive a plain text list (CSV) of IPv4 based on Min Score.

HTTP Request

GET /api/v1/flat/<min_score>?list=NO HTTP/1.1
Host: app.onefirewall.com
Authorization: Bearer PLACE_YOUR_OWN_TOKEN_HERE
Input
Variable Possible Values Notes
min_score 1 to 1000 (Integer) Minimum WCF Crime Score Feeds
list YES or NO (String) NO=the output is CSV, YES=the output is a list of IPs separated by ‘,’
Output

The possible HTTP Code responses are:

  • 200 OK: The request was received and processed successfully
  • 400 Bad Request: The request was malformed (body contains further explanations)
  • 401 Unauthorized: The request not authorized (body contains further explanations)
  • 402 Payment Required: Not enogh OneFirewall Coins to perform the request
  • 5XX Internal Server Error: The service is momentarily unavailable

In case of an 200 response the body will be presented as the below examples:

CSV (in case list=NO or not presented in the request)
IPv4,LiveScore,Members,Reports,LastUpdate,AS,ASN,CDN,Reverse,IS_CDN
X.Y.Z.W,216,3,21,2023-04-29T04:43:54.000Z,<ASXXXX>,<Autonomous System Name>,<CDN Name>,<reverse DNS query>,<'Well-known CDN' in case of Valid CDN>
X.Y.Z.W,211,3,45,2023-04-28T09:21:50.000Z,<ASXXXX>,<Autonomous System Name>,<CDN Name>,<reverse DNS query>,<'Well-known CDN' in case of Valid CDN>
X.Y.Z.W,217,3,32,2023-04-29T05:54:04.000Z,<ASXXXX>,<Autonomous System Name>,<CDN Name>,<reverse DNS query>,<'Well-known CDN' in case of Valid CDN>
X.Y.Z.W,204,3,53,2023-04-29T04:58:13.000Z,<ASXXXX>,<Autonomous System Name>,<CDN Name>,<reverse DNS query>,<'Well-known CDN' in case of Valid CDN>
.....
Output Explanation

The column returns a CSV formated with the below information:

  • IPv4: - Mandatory - IPv4
  • LiveScore: - Mandatory - Update OFA Crime Score
  • Members: Mandatory - Count of total Members reported this IP
  • Reports: Mandatory - Count of total reports made at OneFirewall for this IP
  • LastUpdate: Mandatory - The latest updated date when OneFirewall had a new information about this IP
  • AS: Optional - Autonomous System Number (in format of ASXXX), presented at circa 99,9% of the cases
  • ASN: Optional - Autonomous System Name, presented at circa 99,9% of the cases
  • CDN: Optional - Is the IP is part of known CDN then the name of the CDN Provider will be placed
  • Reverse: Optional - The lastest reverse resolution IP -> Domain name identified, presented 30% of cases
  • IS_CDN: Optional - If the IP is part of known CDN then a static tag (‘Well-known CDN’) will be placed
LIST (in case list=YES presented in the request)
X.Y.Z.W,X.Y.Z.W,X.Y.Z.W,X.Y.Z.W...