> ## Documentation Index > Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt > Use this file to discover all available pages before exploring further. # E-mail-phishinglogboek > Maak het phishinglogboek op gebeurtenisniveau van een eerdere provider opnieuw aan op basis van /v1 reporting-simulatiegebeurtenissen en -entiteiten. Dit rapport is een phishinglogboek op gebeurtenisniveau: één rij per waargenomen simulatie-interactie (datum, actie, e-mailadres van de ontvanger, onderwerp, afzender, moeilijkheidsgraad). Het blijft long-form: de geschiedenis van een persoon wordt niet samengevoegd tot één resultaat. De query vouwt een voorafgaande periode van **12 kalendermaanden** in `occurred_after` (middernacht UTC op dezelfde dag van de maand twaalf maanden geleden, dus niet een periode van 365 dagen). Het ruwe client-IP-adres staat nooit op `/v1`. Dit is privacy by design en geen openstaande mapping. Het apparaattype is een afgeleide klasse op de gebeurtenisrij; de ruwe `user_agent` blijft privé. Zie [Afwijkingen ten opzichte van de legacy-export](#afwijkingen-ten-opzichte-van-de-legacy-export). Installatie, inloggegevens, paginering en nieuwe pogingen bij rate limits zijn hetzelfde als in de [connectiviteitshandleiding voor Power BI / Excel](/nl/developers/v1/powerbi). Voeg eerst de gedeelde `Fn_FetchAll`-query toe; dit rapport roept deze bij naam aan. ## Vereiste sleutelscopes | Scope | Gebruikt voor | | - | - | | `reporting:read` | `GET /v1/reporting/simulation_events` | | `entity:read` | `GET /v1/entities` (koppeling van e-mailadres en weergavenaam) | Een sleutel met alleen `simulation:read` kan het reporting-events-endpoint niet aanroepen (de API retourneert `403`). Zie [het juiste detailniveau kiezen](/nl/developers/v1/powerbi#kies-de-juiste-granulariteit). ## Bronendpoints | Endpoint | Rol | | - | - | | `GET /v1/reporting/simulation_events` | Feit op gebeurtenisniveau. Het detailniveau is één getypte interactie. `email_subject`, `sender_email`, `sender_domain` en `difficulty_tier` staan op deze rij, dus de query koppelt voor deze velden geen resultaten op campagneniveau. | | `GET /v1/entities` | Zet `entity_id` om naar e-mailadres / weergavenaam. De reporting-gebeurtenis bevat het e-mailadres van de ontvanger niet (een harde uitsluiting op de reporting-reader). Via `/entities` wordt de legacy-kolom "email" gevuld. | Toegestane filters voor de lijst met gebeurtenissen (alles wat daarbuiten valt, retourneert `400`): `limit`, `page_token`, `simulation`, `entity`, `event_type`, `occurred_after`. Deze reporting-familie is een [preview-dataset](/nl/developers/v1/powerbi#reporting-previewdatasets-phishing-per-persoon). Bekijk het datasetschema en het databeleid op `GET /v1/reporting/datasets` en `GET /v1/reporting/datasets/simulation_events`. ### Detailniveau Eén rij per reporting-simulatiegebeurtenis. Een persoon die hetzelfde bericht eerst opende en er vervolgens op klikte, levert twee rijen op. Gebeurtenissen met een null-waarde voor `entity_id` (geen actor / ontvanger / doeldeelnemer) verschijnen nog steeds; `email` is dan null. Het API-venster wordt met één minuut verruimd; de exacte `occurred_at >= WindowStart`-grens wordt lokaal opnieuw toegepast, zodat het voorafgaande jaar er niet van afhangt of de server `occurred_after` als inclusief of exclusief behandelt. Aanvraagbudget: één gepagineerde doorloop van gebeurtenissen in het venster, plus één doorloop van entiteiten. Stel altijd `limit = "500"` in. ## Kolommapping De legacy-kolomnamen zijn afkomstig uit de export van uw vorige provider. De `/v1`-velden zijn de openbare API-namen; de query gebruikt voor sommige ervan aliassen in het rapport. | Legacy-kolom | `/v1`-veld of afleiding | Rapportkolom | | - | - | - | | Date | `Event.occurred_at` (als datum; de ruwe `occurred_at` wordt bewaard als `datetimezone`) | `date` | | Action | `Event.event_type` — gesloten tokens, hieronder vermeld | `action` | | Email | `Entity.email` (koppeling via `entity_id`) | `email` | | Subject | `Event.email_subject` | `subject` | | From | `Event.sender_email` | `from` | | Difficulty | `Event.difficulty_tier` — geheel getal van 1–5, waarbij 1 het makkelijkst en 5 het moeilijkst is | `difficulty` | | Raw IP | Nooit op `/v1` | Weggelaten, niet op null gezet | | Device type | `Event.device_type` — afgeleide klasse; null wanneer de gebeurtenis geen afgeleide klasse heeft | `device_type` | ### Actietokens `action` is het gesloten reporting-token. De legacy-waarde "Email Sent" wordt gemapt naar `simulation.delivered` (`delivered` is het openbare werkwoord; het wire-token is `simulation.delivered`). | `action`-waarde | | - | | `simulation.delivered` | | `simulation.opened` | | `simulation.link_clicked` | | `simulation.credentials_submitted` | | `simulation.attachment_opened` | | `simulation.reported` | | `simulation.bounced` | | `simulation.qr_scanned` | | `simulation.replied` | Extra velden die behouden blijven omdat de API ze bevat: `sender_domain`, `full_name`, `event_id`, `entity_id`, `simulation_id`, `occurred_at`, plus `entity_type` en `entity_status` uit de entiteitskoppeling. ## Afwijkingen ten opzichte van de legacy-export * **Het ruwe IP-adres is nooit beschikbaar.** `/v1` maakt het ruwe client-IP-adres niet zichtbaar. Dit is privacy by design en geen openstaande mapping. De query voegt geen tijdelijke IP-kolom toe. * **Het apparaattype is afgeleid, niet ruw.** `device_type` is een afgeleide apparaatklasse voor klik-, verzend- en meldgebeurtenissen. Waargenomen tokens zijn onder meer `desktop`, `mobile`, `tablet` en `unknown`, maar de emitter slaat een vrije tekenreeks op; behandel deze als open tekst, niet als een gesloten enum. De waarde is null wanneer de gebeurtenis geen afgeleide klasse heeft, en de ruwe `user_agent`-tekenreeks blijft privé. * **"Email Sent" is `simulation.delivered`.** Gebruik dat token wanneer u verzendingen filtert of telt. Zoek niet naar een legacy-tekenreeks `email_sent`. * **Het e-mailadres van de ontvanger is een koppeling, geen veld op de gebeurtenis.** De reporting-gebeurtenis bevat geen e-mailadres; de query doorloopt `/entities` om dit in te vullen. * **Voorafgaande 12 kalendermaanden**, niet een periode van 365 dagen en niet de volledige geschiedenis. * **Long-form, niet samengevoegd.** Eén rij per interactie, niet één resultaat per persoon. ## Volgende stappen Inloggegevens, paginering en het laden van deze queries in Power BI of Excel. Overzicht per persoon van klikken, inloggegevens en meldingen over 12 maanden. Training-inschrijvingen op detailniveau van persoon × toewijzing. Verleen `reporting:read` en `entity:read` aan de sleutel die dit rapport vernieuwt. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.