[{"data":1,"prerenderedAt":162},["ShallowReactive",2],{"doc:\u002Freference\u002Flist-events":3},{"page":4,"toc":158,"updated":161},{"path":5,"title":6,"seoTitle":7,"description":8,"blocks":9,"examples":109},"\u002Freference\u002Flist-events","List events","List Events: GET \u002Fevents","List identification events in a time window, newest first, filtered by visitor or suspect level.",[10,15,18,44,64,66,71,82,84,87,105],{"type":11,"method":12,"path":13,"auth":14},"endpoint","GET","\u002Fapi\u002Fv1\u002Fevents","secret",{"type":16,"text":17},"p","Returns events from the secret key's own organization and environment, newest first. The window can reach back 30 days.",{"type":19,"method":12,"path":13,"params":20},"try-it",[21,25,32,35,38,41],{"name":22,"in":23,"placeholder":24},"limit","query","10",{"name":26,"in":23,"options":27},"level",[28,29,30,31],"","low","medium","high",{"name":33,"in":23,"placeholder":34},"visitor","X9pL2mRc7KvT4bQw8NdF",{"name":36,"in":23,"placeholder":37},"from","2026-09-16T00:00:00Z",{"name":39,"in":23,"placeholder":40},"to","2026-09-17T00:00:00Z",{"name":42,"in":23,"placeholder":43},"page","1",{"type":45,"title":46,"fields":47},"fields","Query parameters",[48,52,55,58,60,62],{"name":36,"type":49,"text":50,"default":51},"string","Start of the window, inclusive, RFC 3339.","24 hours ago",{"name":39,"type":49,"text":53,"default":54},"End of the window, exclusive, RFC 3339.","now",{"name":42,"type":56,"text":57,"default":43},"integer","One-based page number. The offset may not exceed 10,000 events.",{"name":22,"type":56,"text":59,"default":24},"Events per page, at most 200.",{"name":33,"type":49,"text":61},"Only events for this exact visitor ID.",{"name":26,"type":49,"text":63},"Only events at `low`, `medium` or `high`.",{"type":16,"text":65},"`from` must be before `to`, the window may span at most 30 days, and it may not start more than 30 days ago. Otherwise the request fails with `422 invalid_window`.",{"type":67,"level":68,"text":69,"id":70},"heading",2,"Response","response",{"type":45,"fields":72},[73,77,79],{"name":74,"type":75,"text":76},"rows","array","The events on this page. Each has the [event fields](\u002Freference\u002Fget-event#response).",{"name":42,"type":56,"text":78},"This page's number.",{"name":80,"type":56,"text":81},"page_size","The page size applied.",{"type":16,"text":83},"There is no total count. A page with fewer rows than `page_size` is the last one.",{"type":67,"level":68,"text":85,"id":86},"Errors","errors",{"type":88,"columns":89,"rows":93},"table",[90,91,92],"Status","Code","When",[94,98,102],[95,96,97],"`401`","`unauthorized`","The key is not a valid secret key.",[99,100,101],"`422`","`invalid_window`","The window, page offset, level or visitor filter is not valid.",[99,103,104],"`validation_error`","A parameter has the wrong type.",{"type":106,"tone":107,"text":108},"callout","note","The server API does not answer browsers: a secret key sent with an `Origin` header is refused. Call it from your backend.",{"request":110,"response":150},[111,115,119,123,126,130,134,138,142,146],{"label":112,"lang":113,"code":114},"cURL","bash","curl \"https:\u002F\u002Fus.api.fingerly.io\u002Fapi\u002Fv1\u002Fevents?level=high&limit=50\" \\\n  -H \"x-api-key: $FINGERLY_SECRET_KEY\"",{"label":116,"lang":117,"code":118},"Node.js","ts","const page = await fingerly.events.list({ level: 'high', limit: 50 })",{"label":120,"lang":121,"code":122},"Python","python","page = fingerly.events.list(level=\"high\", limit=50)",{"label":124,"lang":121,"code":125},"Python (async)","page = await fingerly.events.list(level=\"high\", limit=50)",{"label":127,"lang":128,"code":129},"Go","go","page, err := client.Events.List(ctx, &fingerly.EventListParams{Level: \"high\", Limit: 50})",{"label":131,"lang":132,"code":133},"Java","java","EventPage page = fingerly.events().list(EventListParams.builder().level(\"high\").limit(50).build());",{"label":135,"lang":136,"code":137},".NET","csharp","var page = await fingerly.Events.ListAsync(new EventListOptions { Level = \"high\", Limit = 50 });",{"label":139,"lang":140,"code":141},"PHP","php","$page = $fingerly->events->list(['level' => 'high', 'limit' => 50]);",{"label":143,"lang":144,"code":145},"Ruby","ruby","page = fingerly.events.list(level: \"high\", limit: 50)",{"label":147,"lang":148,"code":149},"Rust","rust","let page = fingerly.events().list(&ListEvents { level: Some(Level::High), limit: Some(50), ..Default::default() }).await?;",[151,155],{"label":152,"lang":153,"code":154},"200","json","{\n  \"rows\": [\n    {\n      \"request_id\": \"01a0a84b-e6a2-7c09-9f51-0b3d7a26c8e4\",\n      \"visitor_id\": \"X9pL2mRc7KvT4bQw8NdF\",\n      \"occurred_at\": \"2026-09-16T09:41:12.482Z\",\n      \"state\": \"enriched\",\n      \"environment\": \"production\",\n      \"platform\": \"web\",\n      \"sdk_platform\": \"web\",\n      \"sdk_version\": \"0.1.0\",\n      \"origin\": \"https:\u002F\u002Fshop.example.com\",\n      \"tag\": \"checkout:8412\",\n      \"ip_address\": \"203.0.113.42\",\n      \"country_code\": \"DE\",\n      \"country_name\": \"Germany\",\n      \"asn\": \"AS64502\",\n      \"asn_name\": \"Example Hosting\",\n      \"anonymity_network\": \"tor\",\n      \"agent\": \"Firefox\",\n      \"agent_version\": \"128.0\",\n      \"os\": \"Windows\",\n      \"device_kind\": \"desktop\",\n      \"visitor_kind\": \"automation\",\n      \"suspect_score\": 37,\n      \"suspect_level\": \"high\",\n      \"triggers\": [\n        {\n          \"signal\": \"tor\",\n          \"weight\": 14,\n          \"confidence\": \"high\"\n        },\n        {\n          \"signal\": \"bot\",\n          \"weight\": 9,\n          \"confidence\": \"medium\"\n        },\n        {\n          \"signal\": \"browser_tampering\",\n          \"weight\": 8,\n          \"confidence\": \"medium\"\n        },\n        {\n          \"signal\": \"high_activity\",\n          \"weight\": 6,\n          \"confidence\": \"low\"\n        }\n      ],\n      \"has_document\": true\n    }\n  ],\n  \"page\": 1,\n  \"page_size\": 50\n}",{"label":156,"lang":153,"code":157},"422","{\n  \"error\": {\n    \"code\": \"invalid_window\",\n    \"message\": \"the event window must be positive and within retention\",\n    \"status\": 422\n  },\n  \"request_id\": \"01a0a84c-0f11-7a3e-9c2d-4b5e6f708192\"\n}",[159,160],{"id":70,"text":69,"level":68},{"id":86,"text":85,"level":68},"2026-09-17T16:56:32.000Z",1789667797850]