List recent threats

GET

https://api.ocean.security/api/v1/api/v1/threats

Returns a paginated list of recent threats, optionally filtered by the number of days to look back.

Request

Query Params

Header Params

Responses

🟢200OK

application/json

A paginated list of threats

Body

🟠400Bad Request

🟠401Unauthorized

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.ocean.security/api/v1/api/v1/threats' \
--header 'X-Api-Key;'

Response Example

200 - Example 1

{
    "pagination": {
        "page": 0,
        "page_size": 0,
        "total": 0
    },
    "results": {
        "items": [
            {
                "id": "string",
                "recipient_email": "string",
                "recipient_name": "string",
                "sender_email": "string",
                "sender_name": "string",
                "source": "string",
                "subject": "string",
                "threat_indicators": [
                    {
                        "indicator_type": "string"
                    }
                ],
                "threat_type": "string",
                "time": "1970-01-01T11:59:59.000Z"
            }
        ]
    },
    "status": 0
}

Modified at 2025-07-27 09:03:30

Get top threat types

Get threat by ID