Skip to Content
ReferenceAPI referenceAbuseIPDB

List every report sent to AbuseIPDB

GET
/api/v1/abuseipdb/reports/history

Returns the reports sent from GeoMetrikks, newest first, paged with currentPage and pageSize. An IP reported twice appears twice. Read from the local database; nothing leaves the server.

Authorization

cookiesession<token>

Session cookie authentication.

Query Parameters

currentPage?integer

The page to return, counted from 1. Defaults to 1.

Range1 <= value
Default1
pageSize?integer

Rows per page, from 1 to 500. Defaults to 10.

Range1 <= value <= 500
Default10
q?|

Search, up to 200 characters. Matches the start of the IP, or part of the comment or the sender's name, ignoring case.

Lengthlength <= 200
categoryIn?array<integer>|

Keep only reports with any of these AbuseIPDB category IDs, from 1 to 23. Repeat the parameter to pass more than one.

statusIn?array<>|

Keep only reports in any of these states. Repeat the parameter to pass more than one.

Response Body

Request fulfilled, document follows

application/json
  1. response

One page of results. total counts the matches on every page, limit is the page size and offset is how many matches come before this page.

items?array<>
limit?integer

Maximal number of items to send.

offset?integer

Offset from the beginning of the query.

total?integer

Total number of items.

Example Request
curl -X GET 'https://geometrikks.example.com/api/v1/abuseipdb/reports/history'
Example Response
{  "items": [    {      "abuseConfidenceScore": 0,      "attackTime": "2019-08-24T14:15:22Z",      "categories": [        0      ],      "comment": "string",      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "ipAddress": "string",      "reportedAt": "2019-08-24T14:15:22Z",      "reporterKind": "user",      "reporterName": "string",      "status": "unconfirmed"    }  ],  "limit": 0,  "offset": 0,  "total": 0}