TENANT API · V1
List integration events Replay cursor, bounded type/resource filters.
GET /api/v1/tenant/events
Authorization Use a server-side API key with the listed grants and permitted resource access.
Response 200 OK
Returns the authorized resource or result for this operation. List results use items, nextCursor, and hasMore.
Behavior to account for Events are delivered at least once. Deduplicate by event ID, compare resource versions, and retain a replay cursor.
Errors Authentication failures return 401 or 403. Inaccessible resources return 404. Business and idempotency conflicts return 409. Rate limits return 429 with retry guidance.
Error handling guide REQUEST API key
curl --request GET 'https://api.wincora.com/api/v1/tenant/events' \ --header 'X-Api-Key: YOUR_API_KEY' const response = await fetch ( 'https://api.wincora.com/api/v1/tenant/events' , { method: 'GET' , headers: { "X-Api-Key" : process.env. WINCORA_API_KEY } }); if ( ! response.ok) throw new Error ( await response. text ()); const result = await response. json (); import os import requests response = requests.request( 'GET' , 'https://api.wincora.com/api/v1/tenant/events' , headers = { "X-Api-Key" : os.environ[ "WINCORA_API_KEY" ] }, timeout = 30 , ) response.raise_for_status() result = response.json() RESPONSE EXAMPLE 200
{ "items" : [ { "id" : "evt_example" , "type" : "case.action_required" , "schemaVersion" : "1" , "occurredAt" : "2026-09-23T15:05:00Z" , "resource" : { "type" : "case" , "id" : "case_example" , "version" : "17" }, "data" : { "reason" : "additional_information" , "collectionRequestId" : "cr_example" } } ], "nextCursor" : "cursor_example" , "hasMore" : false } Keep this API key on your server. Never embed it in browser or mobile code.
