{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/caliza/json-schema/caliza-verification-response-schema.json",
  "title": "VerificationResponse",
  "description": "KYC/KYB verification session details including status, type, and the verification URL for interactive sessions.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/caliza-kyc-kyb-v1-api-openapi.yml#/components/schemas/VerificationResponse",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique identifier of the verification session."
    },
    "beneficiaryId": {
      "type": "string",
      "description": "Unique identifier of the beneficiary being verified."
    },
    "type": {
      "type": "string",
      "description": "Beneficiary type. `INDIVIDUAL` triggers KYC workflows, `BUSINESS` triggers KYB workflows.",
      "enum": [
        "INDIVIDUAL",
        "BUSINESS"
      ]
    },
    "verificationType": {
      "type": "string",
      "description": "The verification mode used for this session.",
      "enum": [
        "INTERACTIVE"
      ]
    },
    "verificationUrl": {
      "type": [
        "string",
        "null"
      ],
      "description": "URL where the end user must be redirected to complete verification. Present when status is `PENDING`. Becomes `null` once verification is no longer pending."
    },
    "status": {
      "type": "string",
      "description": "Current status of the verification session.",
      "enum": [
        "PENDING",
        "PROCESSING",
        "SUCCEEDED",
        "FAILED"
      ]
    },
    "createdDate": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "Timestamp when the verification session was created."
    },
    "lastModifiedDate": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "Timestamp of the last status update."
    }
  }
}