Overview
API Concepts Manage API Key
Internet Data
DNSIQ® WHOISIQ™ SSL Certificates Blacklist Lookup Host Attributes
Attack Analytics
Newly Observed Domains Newly Observed Hosts Malware Phishing Scam Content
Digital Footprint
Global Inventory API Global Inventory Schema
Coming Soon
Enrich
PassiveTotal
Actions Artifact Enrichment Exposed Services Monitor Project SSL Certificates Tag Artifact Trackers Host Attributes Passive DNS Whois Bulk Enrichment
Additional Resources
Workspace Management API
RiskIQ.com

Monitor

Retrieve all alerts associated with an artifact or project.

 

What It Looks Like

Curl Example

# Fetch by artifact
$ curl -u $USERNAME:$KEY 'https://api.riskiq.net/pt/v2/monitor?artifact=838439d8-d291-4e20-dec8-05c8f7f7ba57'

# Fetch by project after start datetime
$ curl -u $USERNAME:$KEY 'https://api.riskiq.net/pt/v2/monitor?project=838439d8-d291-4e20-dec8-05c8f7f7ba57&start=2017-04-01 00:00:00'

Parameters

Field Type Description
project (optional) UUID

the project to filter on

artifact (optional) UUID

the artifact to filter on

start (optional) Datetime

filter results to after this datetime

end (optional) Datetime

filter results to before this datetime

size (optional) Number

max number of results.
Default value: 25

page (optional) Number

page number.
Default value: 0

Sample Response (Artifact Query)

{
  "results": {
    "a9969326-4310-175d-d422-e83a36edaae0": [
      {
        "type": "pdns",
        "result": "8.8.8.8",
        "query": "something.example.org",
        "datetime": "2017-04-15T00:34:44.260000",
        "tags": [],
        "change": "new resolution",
        "project": "Disco Inferno"
      },
      ...
      {
        "type": "pdns",
        "result": "::ffff:8:8:8:8",
        "query": "something.example.org",
        "datetime": "2017-04-15T00:34:44.260000",
        "tags": [],
        "change": "new resolution",
        "project": "Disco Inferno"
      }
    ]
  },
  "error": null,
  "success": true,
  "totalRecords": 2
}

            

Sample Response (Project Query)

{
    "results": {
        "a9969326-4310-175d-d422-e83a36edaae0": [
            {
                "type": "pdns",
                "result": "10.0.0.1",
                "query": "foo.example.org",
                "datetime": "2017-04-15T00:34:44.260000",
                "tags": [],
                "change": "new resolution",
                "project": "Parov Stelar Indicators"
            },
            {
                "type": "pdns",
                "result": "::1",
                "query": "foo.example.org",
                "datetime": "2017-04-15T00:34:44.260000",
                "tags": [],
                "change": "new resolution",
                "project": "Parov Stelar Indicators"
            }
        ],
        "838439d8-d291-4e20-dec8-05c8f7f7ba57": [
            {
                "type": "pdns",
                "result": "10.0.0.10",
                "query": "example.org",
                "datetime": "2017-04-15T00:26:49.708000",
                "tags": [],
                "change": "new resolution",
                "project": "Parov Stelar Indicators"
            }
        ]
    },
    "error": null,
    "success": true,
    "totalRecords": 3
}