Notification Email List

GEThttps://api.deepinfo.com/v1/platform/notification-emails

Lists notification emails that were sent, with the rule that triggered them.

Example

Request

curl

curl 'https://api.deepinfo.com/v1/platform/notification-emails?page_size=25' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json'

Python

import requests

url = "https://api.deepinfo.com/v1/platform/notification-emails"

params = {
    "page_size": "25"
}

headers = {
    "apikey": "YOUR_API_KEY",
    "Accept": "application/json"
}

response = requests.get(url, params=params, headers=headers)
response.raise_for_status()
print(response.json())

JavaScript

const url = "https://api.deepinfo.com/v1/platform/notification-emails?page_size=25";

const response = await fetch(url, {
  method: "GET",
  headers: {
    "apikey": "YOUR_API_KEY",
    "Accept": "application/json"
  },
});

const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.deepinfo.com/v1/platform/notification-emails?page_size=25", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("apikey", "YOUR_API_KEY")
	req.Header.Set("Accept", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	body, err := io.ReadAll(res.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(string(body))
}

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.deepinfo.com/v1/platform/notification-emails?page_size=25"))
            .header("apikey", "YOUR_API_KEY")
            .header("Accept", "application/json")
            .GET()
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}

using System;
using System.Net.Http;

using var client = new HttpClient();

var request = new HttpRequestMessage(HttpMethod.Get, "https://api.deepinfo.com/v1/platform/notification-emails?page_size=25");
request.Headers.Add("apikey", "YOUR_API_KEY");
request.Headers.Add("Accept", "application/json");

using var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.deepinfo.com/v1/platform/notification-emails?page_size=25',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'apikey: YOUR_API_KEY',
        'Accept: application/json',
    ],
]);

$response = curl_exec($curl);

if ($response === false) {
    throw new RuntimeException(curl_error($curl));
}

echo $response . PHP_EOL;

Ruby

require 'net/http'
require 'uri'

uri = URI('https://api.deepinfo.com/v1/platform/notification-emails?page_size=25')

request = Net::HTTP::Get.new(uri)
request['apikey'] = 'YOUR_API_KEY'
request['Accept'] = 'application/json'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

puts response.body

Response

200 OK · application/json

Response Body

{
  "page": 1,
  "page_size": 25,
  "result_count": 21,
  "results": [
    {
      "id": "00000000000000000000000ea8430001",
      "rule": {
        "id": "000000000000000e8e040001",
        "name": "Critical issues",
        "scope": "reappeared_issue_detected",
        "frequency": "instant"
      },
      "sent_at": "2025-07-31T08:00:00Z",
      "recipients": [
        {
          "email": "user@acme.example",
          "full_name": "Jane Doe"
        }
      ],
      "context": {
        "event_date": "2025-07-31T08:00:00.000000+00:00",
        "event_date_humanized": "3 months ago",
        "id": "000000000000000e59ba0001",
        "asset": {
          "id": "000000000000000ea4f90001",
          "name": "acme.example",
          "name_unicode": "acme.example",
          "tags": []
        },
        "severity": "High",
        "last_seen_date": "2025-07-31T08:00:00.000000+00:00",
        "last_seen_date_humanized": "3 months ago",
        "type": {
          "id": "000000000000000e16fe0001",
          "name": "Expired SSL certificate",
          "description": "A security finding the platform detects on an asset.",
          "category": {
            "id": "000000000000000e1c170001",
            "name": "SSL/TLS"
          }
        },
        "first_seen_date": "2025-06-01T08:00:00.000000+00:00",
        "first_seen_date_humanized": "3 months ago"
      }
    },
    {
      "id": "00000000000000000000000ea8430002",
      "rule": {
        "id": "000000000000000e8e040002",
        "name": "New vulnerabilities",
        "scope": "reappeared_issue_detected",
        "frequency": "instant"
      },
      "sent_at": "2025-07-24T08:00:00Z",
      "recipients": [
        {
          "email": "user@acme.example",
          "full_name": "Jane Doe"
        }
      ],
      "context": {
        "event_date": "2025-07-24T08:00:00.000000+00:00",
        "event_date_humanized": "3 months ago",
        "id": "000000000000000e59ba0002",
        "asset": {
          "id": "000000000000000ea4f90002",
          "name": "fernhill.example",
          "name_unicode": "fernhill.example",
          "tags": []
        },
        "severity": "Medium",
        "last_seen_date": "2025-07-24T08:00:00.000000+00:00",
        "last_seen_date_humanized": "3 months ago",
        "type": {
          "id": "000000000000000e16fe0002",
          "name": "Missing DMARC record",
          "description": "A security finding the platform detects on an asset.",
          "category": {
            "id": "000000000000000e1c170002",
            "name": "DNS"
          }
        },
        "first_seen_date": "2025-05-25T08:00:00.000000+00:00",
        "first_seen_date_humanized": "3 months ago"
      }
    }
  ]
}

Content-Type: application/json
deepinfo-request-id: 00000000-0000-4000-8000-0000356d0001

Request

curl

curl 'https://api.deepinfo.com/v1/platform/notification-emails?page=0' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json'

Python

import requests

url = "https://api.deepinfo.com/v1/platform/notification-emails"

params = {
    "page": "0"
}

headers = {
    "apikey": "YOUR_API_KEY",
    "Accept": "application/json"
}

response = requests.get(url, params=params, headers=headers)
response.raise_for_status()
print(response.json())

JavaScript

const url = "https://api.deepinfo.com/v1/platform/notification-emails?page=0";

const response = await fetch(url, {
  method: "GET",
  headers: {
    "apikey": "YOUR_API_KEY",
    "Accept": "application/json"
  },
});

const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.deepinfo.com/v1/platform/notification-emails?page=0", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("apikey", "YOUR_API_KEY")
	req.Header.Set("Accept", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	body, err := io.ReadAll(res.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(string(body))
}

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.deepinfo.com/v1/platform/notification-emails?page=0"))
            .header("apikey", "YOUR_API_KEY")
            .header("Accept", "application/json")
            .GET()
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}

using System;
using System.Net.Http;

using var client = new HttpClient();

var request = new HttpRequestMessage(HttpMethod.Get, "https://api.deepinfo.com/v1/platform/notification-emails?page=0");
request.Headers.Add("apikey", "YOUR_API_KEY");
request.Headers.Add("Accept", "application/json");

using var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.deepinfo.com/v1/platform/notification-emails?page=0',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'apikey: YOUR_API_KEY',
        'Accept: application/json',
    ],
]);

$response = curl_exec($curl);

if ($response === false) {
    throw new RuntimeException(curl_error($curl));
}

echo $response . PHP_EOL;

Ruby

require 'net/http'
require 'uri'

uri = URI('https://api.deepinfo.com/v1/platform/notification-emails?page=0')

request = Net::HTTP::Get.new(uri)
request['apikey'] = 'YOUR_API_KEY'
request['Accept'] = 'application/json'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

puts response.body

Response

400 Bad Request · application/json

Response Body

{
  "code": 10400,
  "parameters": [
    {
      "param": "page",
      "details": [
        "Ensure this value is greater than or equal to 1."
      ]
    }
  ],
  "solution": "https://docs.deepinfo.com/reference/"
}

Content-Type: application/json
deepinfo-request-id: 00000000-0000-4000-8000-0000356d0001

Authentication

Send your API key in the apikey request header.

Query Parameters

Parameter	Required	Description
`page_size`	Optional	Min `25`, max `100`. Default `100`. Example`25`
`ordering`	Optional
`page`	Optional	Min `1`, max `800`. Default `1`. Example`1`
`rule__id`	Optional
`rule__name__icontains`	Optional
`rule__scope`	Optional	One of: `new_issue_detected`, `reappeared_issue_detected`, `asset_security_score_decreased`, `asset_security_score_changed`, `asset_ssl_changed`, `asset_whois_changed`, `asset_dns_changed`, `domain_security_score_decreased`, `domain_security_score_changed`, `new_asset_discovered`, `new_asset_added`, `new_vulnerability_detected`, `reappeared_vulnerability_detected`, `new_email_breach_detected`, `new_suspicious_domain_detected`, `new_fraudulent_domain_detected`, `new_open_port_detected`, `new_employee_credential_detected`, `new_client_credential_detected`, `new_payment_credential_detected`, `new_cybersecurity_news_added`.
`rule__frequency`	Optional	One of: `instant`, `hourly`, `daily`, `weekly`, `monthly`.
`sent_at__gte`	Optional
`sent_at__lte`	Optional

Response Fields

Field	Type	Description
`page`	integer
`page_size`	integer
`result_count`	integer
`results`	array of object
`results[].id`	string
`results[].rule`	object
`results[].sent_at`	string	date-time
`results[].recipients`	array of object
`results[].context`	object

Paginated. See Getting Started → Pagination.

Response Schema

Inferred from examples Built from the saved 2xx example response: the fields it contains, with the types seen there. It is not a contract.

Field	Type	Example
`page`	number	`1`
`page_size`	number	`25`
`result_count`	number	`21`
`results`	array<object>
`results[].id`	string	`"00000000000000000000000ea8430001"`
`results[].rule`	object
`results[].rule.id`	string	`"000000000000000e8e040001"`
`results[].rule.name`	string	`"Critical issues"`
`results[].rule.scope`	string	`"reappeared_issue_detected"`
`results[].rule.frequency`	string	`"instant"`
`results[].sent_at`	string	`"2025-07-31T08:00:00Z"`
`results[].recipients`	array<object>
`results[].recipients[].email`	string
`results[].recipients[].full_name`	string	`"Jane Doe"`
`results[].context`	object
`results[].context.event_date`	string	`"2025-07-31T08:00:00.000000+00:00"`
`results[].context.event_date_humanized`	string	`"3 months ago"`
`results[].context.id`	string	`"000000000000000e59ba0001"`
`results[].context.asset`	object
`results[].context.asset.id`	string	`"000000000000000ea4f90001"`
`results[].context.asset.name`	string	`"acme.example"`
`results[].context.asset.name_unicode`	string	`"acme.example"`
`results[].context.asset.tags`	array
`results[].context.severity`	string	`"High"`
`results[].context.last_seen_date`	string	`"2025-07-31T08:00:00.000000+00:00"`
`results[].context.last_seen_date_humanized`	string	`"3 months ago"`
`results[].context.type`	object
`results[].context.type.id`	string	`"000000000000000e16fe0001"`
`results[].context.type.name`	string	`"Expired SSL certificate"`
`results[].context.type.description`	string	`"A security finding the platform det…"`
`results[].context.type.category`	object
`results[].context.type.category.id`	string	`"000000000000000e1c170001"`
`results[].context.type.category.name`	string	`"SSL/TLS"`
`results[].context.first_seen_date`	string	`"2025-06-01T08:00:00.000000+00:00"`
`results[].context.first_seen_date_humanized`	string	`"3 months ago"`

Examples

Selecting one loads it into the request and response panels.

Reference updated September 27, 2026