secuveriAPI docs
OpenAPIMarkdown

kyb_case.reviewed

POSTto your webhook endpoint

A reviewer approved or declined a business case. Signed with the secuveri-signature header (HMAC-SHA256 of "<t>.<raw body>" with your endpoint's signing secret) and, when result signing is configured, a detached ES256 JWS in secuveri-jws.

Check secuveri-signature before you trust the body. See Webhooks.

Headers

  • secuveri-signaturestringrequired
  • secuveri-jwsstring
  • secuveri-event-idstringrequired
  • secuveri-event-typestringrequired

Payloadapplication/json

  • idstringrequired

    Stable across retries; use it to drop duplicates.

  • typestringrequired

    One ofverification.completedverification.review_requiredverification.reviewedverification.expiredkyb_case.completedkyb_case.review_requiredkyb_case.revieweddocuments.verify.completedproof_of_address.read.completedwebhook.test

  • created_atstringdate-timerequired
  • organization_idstringrequired
  • dataobjectrequired
    Show 15 child properties
    • verification_idstring | null
    • session_idstring | null
    • workflow_idstring | null
    • vendor_datastring | null
    • metadataobject | null
    • statusstring | null
    • verdictstring | null
    • decisionstring | null

      verification.reviewed and kyb_case.reviewed only.

      One ofAPPROVEREJECT

    • manual_overrideboolean
    • identification_methodstring | null

      How the person was identified, once the verification has a report.

      One ofswiss_eidswiss_eid_agereusable_credentialface_checknfcdocument

    • swiss_eid_betaboolean

      true when the result rests on a swiyu beta credential, which is not a proof of identity.

    • testboolean
    • kyb_case_idstring

      kyb_case.* events only; verification_id and session_id are null.

    • check_idstring

      Standalone check events only.

    • productstring

      Standalone check events only.

Responses

  • 2XXReceived. Any other answer, a redirect or a timeout after 10 s is retried.
Example payload
{
  "id": "0b8f4f5e-3c2a-4d1b-9e7f-6a5c4b3d2e1f",
  "type": "kyb_case.reviewed",
  "created_at": "2026-10-23T09:12:44.120Z",
  "organization_id": "<your organization id>",
  "data": {
    "verification_id": "VRF-7KQ2M9XA",
    "session_id": "6f1c2e0a-8f43-4f7e-9a51-2b7c1d9e4a10",
    "workflow_id": "<published workflow id>",
    "vendor_data": "customer-1042",
    "metadata": null,
    "status": "COMPLETE",
    "verdict": "APPROVED",
    "decision": "APPROVE",
    "manual_override": false,
    "identification_method": "swiss_eid",
    "swiss_eid_beta": true,
    "test": false,
    "kyb_case_id": "<kyb case id>",
    "check_id": "<check id>",
    "product": "<product>"
  }
}