[{"data":1,"prerenderedAt":104},["ShallowReactive",2],{"doc:\u002Freference\u002Fdeferred-report":3},{"page":4,"toc":100,"updated":103},{"path":5,"title":6,"seoTitle":7,"description":8,"blocks":9,"examples":86},"\u002Freference\u002Fdeferred-report","Submit a deferred report","Deferred Report: POST \u002Fevents\u002F{request_id}\u002Fsupplement","Attach the signals an SDK collects after its initial budget to an identification that has already been answered.",[10,15,18,22,31,44,49,51,59,61,64],{"type":11,"method":12,"path":13,"auth":14},"endpoint","POST","\u002Fapi\u002Fv1\u002Fevents\u002F{request_id}\u002Fsupplement","public",{"type":16,"text":17},"p","Some signals take longer to read than the initial collection budget allows. The browser SDK sends them afterwards with this endpoint. A deferred report is archived with the event and returned as `deferred_signals` by [Get an event](\u002Freference\u002Fget-event). It never changes the visitor ID, the score, billing or webhooks.",{"type":19,"tone":20,"text":21},"callout","note","The JavaScript SDK sends deferred reports automatically. You do not need to call this endpoint.",{"type":23,"title":24,"fields":25},"fields","Path parameters",[26],{"name":27,"type":28,"text":29,"required":30},"request_id","string","The `request_id` from the identify response.",true,{"type":23,"title":32,"fields":33},"Body",[34,37,41],{"name":35,"type":28,"text":36,"required":30},"token","The `deferred_token` from the identify response. Valid for 24 hours, for the same key and origin.",{"name":38,"type":39,"text":40,"required":30},"sdk","object","The SDK's `platform` and `version`.",{"name":42,"type":39,"text":43,"required":30},"signals","The deferred-tier report. Produced by the SDK.",{"type":45,"level":46,"text":47,"id":48},"heading",2,"Response","response",{"type":16,"text":50},"`202 Accepted`:",{"type":23,"fields":52},[53,55],{"name":27,"type":28,"text":54},"The request the report was attached to.",{"name":56,"type":57,"text":58},"duplicate","boolean","`true` when this exact report was already accepted. Omitted otherwise.",{"type":16,"text":60},"Deferred reports are free.",{"type":45,"level":46,"text":62,"id":63},"Errors","errors",{"type":65,"columns":66,"rows":70},"table",[67,68,69],"Status","Code","When",[71,75,79,82],[72,73,74],"`409`","`supplement_conflict`","A different report was already accepted for this request.",[76,77,78],"`422`","`invalid_supplement`","The token is invalid, expired or for another request, or the report is not a deferred report.",[76,80,81],"`invalid_request_id`","The path is not a Fingerly request ID.",[83,84,85],"`503`","`service_unavailable`","The report could not be accepted just now.",{"request":87,"response":92},[88],{"label":89,"lang":90,"code":91},"cURL","bash","curl -X POST \"https:\u002F\u002Fus.api.fingerly.io\u002Fapi\u002Fv1\u002Fevents\u002F01a0a84b-e6a2-7c09-9f51-0b3d7a26c8e4\u002Fsupplement\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"x-api-key: fly_pk_us_production_…\" \\\n  -H \"Origin: https:\u002F\u002Fshop.example.com\" \\\n  -d '{\n    \"token\": \"v1.eyJyZXF1ZXN0X2lkIjoi….…\",\n    \"sdk\": { \"platform\": \"web\", \"version\": \"0.1.0\" },\n    \"signals\": { \"tiers\": [\"deferred\"], \"…\": \"…\" }\n  }'",[93,97],{"label":94,"lang":95,"code":96},"202","json","{\n  \"request_id\": \"01a0a84b-e6a2-7c09-9f51-0b3d7a26c8e4\"\n}",{"label":98,"lang":95,"code":99},"409","{\n  \"error\": {\n    \"code\": \"supplement_conflict\",\n    \"message\": \"a different deferred report was already accepted\",\n    \"status\": 409\n  },\n  \"request_id\": \"01a0a84c-0f11-7a3e-9c2d-4b5e6f708192\"\n}",[101,102],{"id":48,"text":47,"level":46},{"id":63,"text":62,"level":46},"2026-09-17T08:28:36.000Z",1789667797856]