> ## 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. # Meest vatbare gebruikers > Maak het 12-maandenoverzicht van de meest vatbare gebruikers van een vorige provider opnieuw aan op basis van /v1-simulatieresultaten en -entiteiten. Dit rapport is een overzicht van de vatbaarheid per gebruiker over 12 maanden: één rij per persoon die in het afgelopen jaar ten minste één simulatie heeft ontvangen, met aantallen en percentages voor klikken, inloggegevens en meldingen, een huidige klikreeks en een samengevoegde lijst met de laatste 5 uitkomsten. De periode beslaat **12 kalendermaanden** (middernacht UTC op dezelfde dag van de maand twaalf maanden geleden), niet een duur van 365 dagen. Interacties van geautomatiseerde scanners en bots worden uitgesloten van de aantallen voor klikken en inloggegevens. Dit is een bewuste afwijking van de verouderde export. Zie [Afwijkingen ten opzichte van de verouderde export](#afwijkingen-ten-opzichte-van-de-verouderde-export). Installatie, inloggegevens, paginering en nieuwe pogingen bij ratelimits 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 | | - | - | | `simulation:read` | `GET /v1/simulation_results` | | `entity:read` | `GET /v1/entities` (koppeling van e-mailadres en weergavenaam) | Dit rapport gebruikt de **operationele** lijst met resultaten per persoon, niet de preview-familie voor rapportage. Een sleutel die alleen `reporting:read` heeft gekregen, kan `GET /v1/simulation_results` niet aanroepen (de API retourneert `403`). Zie [kies het juiste detailniveau](/nl/developers/v1/powerbi#kies-de-juiste-granulariteit). ## Bronendpoints | Endpoint | Rol | | - | - | | `GET /v1/simulation_results` | Uitkomst per ontvanger. Dit is het feitelijke detailniveau. | | `GET /v1/entities` | Herleidt `entity` → e-mailadres / weergavenaam. De resultaatrij bevat zelf geen e-mailadres of weergavenaam van de ontvanger (alleen `entity`). | Filters op de toegestane lijst voor de resultatenlijst: `limit`, `page_token`, `simulation`, `entity`. Deze lijst heeft geen `delivered_after` / `start_date`, dus de afgelopen 12 maanden worden in Power Query toegepast na de volledige doorloop. Gebruikte velden per resultaat: `id`, `simulation`, `entity`, `status`, `targeted_at`, `delivered_at`, `bounced_at`, `opened_at`, `clicked_at`, `attachment_opened_at`, `credential_submitted_at`, `reported_at`, `reported_before_interaction`, `bot_activity_detected`, `email_subject`, `sender_email`, `difficulty_level`, `created_at`, `updated_at`. ### Detailniveau Eén rij per entiteit met ten minste één resultaat met `delivered_at` in de afgelopen 12 kalendermaanden. Een persoon die wel is geselecteerd maar nooit iets heeft ontvangen, komt niet voor. Meerdere simulaties voor dezelfde persoon worden hier samengevoegd. Aanvraagbudget: één gepagineerde doorloop van alle simulatieresultaten in de organisatie, plus één doorloop van entiteiten. Stel altijd `limit = "500"` in. ## Voorrang van uitkomsten (`last_5_assessments`) Elk van de vijf meest recente afgeleverde resultaten (`delivered_at` aflopend) wordt samengevat als `YYYY-MM-DD: `. De eerste overeenkomende tijdstempel wint, met de hoogste prioriteit eerst: | Prioriteit | Tijdstempel | Label van uitkomst | | - | - | - | | 1 | `credential_submitted_at` | `credential submitted` | | 2 | `clicked_at` | `clicked` | | 3 | `attachment_opened_at` | `attachment opened` | | 4 | `reported_at` | `reported` | | 5 | `opened_at` | `opened` | | 6 | `delivered_at` | `no action` | | 7 | `bounced_at` | `bounced` | Alleen afgeleverd is `no action` (het bericht is aangekomen; de persoon heeft niets gedaan). Een persoon die heeft geklikt en later heeft gemeld, is `clicked` — een melding gaat in deze lijst niet voor een risicovolle interactie. Rijen die als bot zijn gemarkeerd krijgen nog steeds een label van uitkomst op basis van de aanwezige tijdstempels; ze verhogen alleen de aantallen voor klikken en inloggegevens niet. **Huidige klikreeks:** doorloop dezelfde afgeleverde resultaten van nieuw naar oud en tel opeenvolgende rijen waarin `clicked_at` niet leeg is **en** `bot_activity_detected` niet `true` is. Stop bij de eerste rij die niet voldoet. ## Kolomtoewijzing De namen van de verouderde kolommen komen uit de export van uw vorige provider. `/v1`-velden zijn de namen in de openbare API; de query leidt de aantallen en percentages af. | Verouderde kolom | `/v1`-veld of afleiding | Rapportkolom | | - | - | - | | E-mailadres | `Entity.email` (koppeling via `Result.entity`) | `email` | | Volledige naam | `Entity.display_name` | `full_name` | | Totaal aantal ontvangen simulaties | Aantal resultaten waarbij `delivered_at` niet leeg is (inclusief als bot gemarkeerde rijen) | `total_received` | | Klikken # | Aantal waarbij `clicked_at` niet leeg is **en** `bot_activity_detected` ≠ `true` | `clicks` | | Klikken % | `clicks / total_received` | `click_pct` | | Ingediende inloggegevens # | Aantal waarbij `credential_submitted_at` niet leeg is **en** `bot_activity_detected` ≠ `true` | `credential_submissions` | | Ingediende inloggegevens % | `credential_submissions / total_received` | `credential_submission_pct` | | Gemeld # | Aantal waarbij `reported_at` niet leeg is (inclusief bots — geen klik of inloggegevens) | `reported` | | Gemeld % | `reported / total_received` | `reported_pct` | | Huidige klikreeks | Opeenvolgende nieuwste afgeleverde resultaten waarop de persoon heeft geklikt (bots verbreken de reeks) | `current_click_streak` | | Laatste 5 beoordelingen | De vijf nieuwste afgeleverde uitkomsten, gescheiden door `"; "` (zie [voorrang](#voorrang-van-uitkomsten-last_5_assessments)) | `last_5_assessments` | | Extra mapgegevens (afdeling, …) | Niet aanwezig op `/v1` | Weggelaten, niet op null gezet | Behouden koppelsleutel voor een sterschemamodel: `entity_id`. ## Afwijkingen ten opzichte van de verouderde export * **Botactiviteit wordt uitgesloten van de aantallen voor klikken en inloggegevens.** De export van een vorige provider telde interacties van geautomatiseerde scanners en bots mee als klikken en ingediende inloggegevens. Deze query doet dat niet. Een resultaat met `bot_activity_detected = true` is nog steeds een afgeleverde simulatie — het telt mee in `total_received` en in de aggregaties voor meldingen — maar wordt behandeld als een niet-klik en een niet-indiening: het wordt weggelaten uit `clicks` / `credential_submissions` en verbreekt een huidige klikreeks. Probeer dit niet te "herstellen" door bots mee te tellen om aan te sluiten op de verouderde export. * **Een melding gaat niet voor een klik** bij `last_5_assessments`. Een persoon die heeft geklikt en later heeft gemeld, krijgt het label `clicked`. * **Extra mapgegevens worden weggelaten, niet op null gezet.** Afdeling en vergelijkbare velden zijn niet aanwezig op `/v1`. * **Geen tijdfilter aan de serverzijde.** `GET /v1/simulation_results` heeft geen `delivered_after`. De query doorloopt alle resultaten en behoudt daarna `delivered_at` in de afgelopen 12 kalendermaanden. Een grote organisatie met veel historie kan meer van het ratelimietbudget per sleutel verbruiken dan een gefilterde lijst. ## Volgende stappen Inloggegevens, paginering en het laden van deze query's in Power BI of Excel. Phishinginteracties op gebeurtenisniveau voor de afgelopen 12 maanden. Training-inschrijvingen op het niveau persoon × toewijzing. Verleen `simulation:read` en `entity:read` aan de sleutel die dit rapport ververst. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.