[{"data":1,"prerenderedAt":216},["ShallowReactive",2],{"doc:\u002Freference\u002Fget-event":3},{"page":4,"toc":212,"updated":215},{"path":5,"title":6,"seoTitle":7,"description":8,"blocks":9,"examples":164},"\u002Freference\u002Fget-event","Get an event","Get an Event: GET \u002Fevents\u002F{request_id}","Read one identification event by its request ID with a secret key. This is how your server verifies what a client reported.",[10,15,18,26,33,38,128,138,142,145],{"type":11,"method":12,"path":13,"auth":14},"endpoint","GET","\u002Fapi\u002Fv1\u002Fevents\u002F{request_id}","secret",{"type":16,"text":17},"p","Returns the stored event for a request ID, from the secret key's own organization and environment. Use it to [verify an identification](\u002Fdocs\u002Fserver-side-verification) before you act on it.",{"type":19,"method":12,"path":13,"params":20},"try-it",[21],{"name":22,"in":23,"required":24,"placeholder":25},"request_id","path",true,"01a0a84b-e6a2-7c09-9f51-0b3d7a26c8e4",{"type":27,"title":28,"fields":29},"fields","Path parameters",[30],{"name":22,"type":31,"text":32,"required":24},"string","The `request_id` an SDK returned.",{"type":34,"level":35,"text":36,"id":37},"heading",2,"Response","response",{"type":27,"fields":39},[40,42,45,48,51,54,57,60,63,66,69,72,75,78,81,84,87,90,93,96,99,102,106,109,124],{"name":22,"type":31,"text":41},"The identification's ID, a UUIDv7.",{"name":43,"type":31,"text":44},"visitor_id","The visitor the device was identified as.",{"name":46,"type":31,"text":47},"occurred_at","When the request arrived, RFC 3339 in UTC.",{"name":49,"type":31,"text":50},"state","`enriched`, or `unavailable` when the network lookup could not run.",{"name":52,"type":31,"text":53},"environment","`production`, `staging` or `development`.",{"name":55,"type":31,"text":56},"platform","The scoring profile applied: `web`, `android` or `ios`.",{"name":58,"type":31,"text":59},"sdk_platform","The SDK that sent the report, such as `web`, `ios` or `flutter-android`.",{"name":61,"type":31,"text":62},"sdk_version","The SDK's version.",{"name":64,"type":31,"text":65},"origin","The site the request came from. Omitted for native apps.",{"name":67,"type":31,"text":68},"tag","Your tag, as sent. Omitted when none was sent.",{"name":70,"type":31,"text":71},"ip_address","The visitor's IP address.",{"name":73,"type":31,"text":74},"country_code","ISO 3166-1 alpha-2 country of the address.",{"name":76,"type":31,"text":77},"country_name","The country's name.",{"name":79,"type":31,"text":80},"asn","The network's autonomous system number.",{"name":82,"type":31,"text":83},"asn_name","The network's name.",{"name":85,"type":31,"text":86},"anonymity_network","`tor`, `vpn`, `proxy` or `hosting`. Omitted for an ordinary connection.",{"name":88,"type":31,"text":89},"agent","The browser or app.",{"name":91,"type":31,"text":92},"agent_version","Its version.",{"name":94,"type":31,"text":95},"os","The operating system.",{"name":97,"type":31,"text":98},"device_kind","`desktop`, `mobile`, `tablet` or `server`.",{"name":100,"type":31,"text":101},"visitor_kind","`human`, `ai_bot`, `automation` or `search_crawler`.",{"name":103,"type":104,"text":105},"suspect_score","integer | null","The score. `null` when the request was not scored.",{"name":107,"type":31,"text":108},"suspect_level","`low`, `medium` or `high`. Omitted when not scored.",{"name":110,"type":111,"text":112,"children":113},"triggers","array","The signal groups that fired, heaviest first. Always present, possibly empty.",[114,117,121],{"name":115,"type":31,"text":116},"signal","The [signal group](\u002Fdocs\u002Fsignals), such as `vpn` or `bot`.",{"name":118,"type":119,"text":120},"weight","integer","The group's combined weight in this score.",{"name":122,"type":31,"text":123},"confidence","`low`, `medium` or `high`.",{"name":125,"type":126,"text":127},"has_document","boolean","Whether the archived submission can be read with [Get an event](\u002Freference\u002Fget-event).",{"type":27,"title":129,"fields":130},"Archived detail",[131,135],{"name":132,"type":133,"text":134},"document","object","The archived submission as Fingerly stored it, including the scoring details: the threshold and weights profile applied. Present when `has_document` is `true` and the archive could be read.",{"name":136,"type":133,"text":137},"deferred_signals","The deferred report attached to this request, when one arrived.",{"type":139,"tone":140,"text":141},"callout","note","Events are readable for 30 days. An event normally becomes readable within a few seconds of the identification. Allow for that when a client sends you a request ID immediately.",{"type":34,"level":35,"text":143,"id":144},"Errors","errors",{"type":146,"columns":147,"rows":151},"table",[148,149,150],"Status","Code","When",[152,156,160],[153,154,155],"`401`","`unauthorized`","The key is not a valid secret key.",[157,158,159],"`404`","`event_not_found`","No such event in this environment, or it is older than 30 days.",[161,162,163],"`422`","`invalid_request_id`","The path is not a Fingerly request ID.",{"request":165,"response":204},[166,170,174,178,181,185,189,193,197,200],{"label":167,"lang":168,"code":169},"cURL","bash","curl \"https:\u002F\u002Fus.api.fingerly.io\u002Fapi\u002Fv1\u002Fevents\u002F01a0a84b-e6a2-7c09-9f51-0b3d7a26c8e4\" \\\n  -H \"x-api-key: $FINGERLY_SECRET_KEY\"",{"label":171,"lang":172,"code":173},"Node.js","ts","const event = await fingerly.events.get('01a0a84b-e6a2-7c09-9f51-0b3d7a26c8e4')",{"label":175,"lang":176,"code":177},"Python","python","event = fingerly.events.get(\"01a0a84b-e6a2-7c09-9f51-0b3d7a26c8e4\")",{"label":179,"lang":176,"code":180},"Python (async)","event = await fingerly.events.get(\"01a0a84b-e6a2-7c09-9f51-0b3d7a26c8e4\")",{"label":182,"lang":183,"code":184},"Go","go","event, err := client.Events.Get(ctx, \"01a0a84b-e6a2-7c09-9f51-0b3d7a26c8e4\")",{"label":186,"lang":187,"code":188},"Java","java","Event event = fingerly.events().get(\"01a0a84b-e6a2-7c09-9f51-0b3d7a26c8e4\");",{"label":190,"lang":191,"code":192},".NET","csharp","var ev = await fingerly.Events.GetAsync(\"01a0a84b-e6a2-7c09-9f51-0b3d7a26c8e4\");",{"label":194,"lang":195,"code":196},"PHP","php","$event = $fingerly->events->get('01a0a84b-e6a2-7c09-9f51-0b3d7a26c8e4');",{"label":198,"lang":199,"code":177},"Ruby","ruby",{"label":201,"lang":202,"code":203},"Rust","rust","let event = fingerly.events().get(\"01a0a84b-e6a2-7c09-9f51-0b3d7a26c8e4\").await?;",[205,209],{"label":206,"lang":207,"code":208},"200","json","{\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}",{"label":210,"lang":207,"code":211},"404","{\n  \"error\": {\n    \"code\": \"event_not_found\",\n    \"message\": \"no such event\",\n    \"status\": 404\n  },\n  \"request_id\": \"01a0a84c-0f11-7a3e-9c2d-4b5e6f708192\"\n}",[213,214],{"id":37,"text":36,"level":35},{"id":144,"text":143,"level":35},"2026-09-17T16:56:32.000Z",1789667797852]