Skip to main content

GET Employee Events

GET /companies/v1/victimsapi/{id}/events

This endpoint retrieves the recorded events for a specific victim along with the associated campaign information.

URL

GET https://back.whalemate.com/api/companies/v1/victimsapi/{id}/events

Headers

{
"X-API-KEY": "YOUR_API_KEY",
"Content-Type": "application/json"
}

Path Params

ParamTypeRequiredDescription
idintegerYesThe employee's ID

Types

{
id: integer,
type: string,
timestamp: date,
campaign: {
id: integer,
title: string,
launch_date: date,
}
}[]

Response

Example of successful response (200 OK)

[
{
id: 501,
type: "click",
timestamp: "2025-09-11T12:30:00Z",
campaign: {
id: 2,
title: "Simulación de Phishing 2025",
launch_date: "2025-09-10T10:00:00Z" ,
}
}
]

Common Errors

CodeMessageCouse
401UnauthorizedAPI Key invalid or missing
400Bad RequestOne or more filters have an invalid format
429Too Many RequestsThe limit of requests was exceeded
500Internal Server ErrorUnexpected server error