CLIENT_VALIDATION_FAILED

Called when a customer's identity is failed for compliance issues

Submit this event using Firing an Event. Product configuration and enabled actions determine the workflow behavior. Use identifiers and snapshots from the same environment.

Request payload#

POST https://api.{ENV}.dais.com/ioi/v3/event/fire

curl --location --request POST 'https://api.{ENV}.dais.com/ioi/v3/event/fire' \
--header 'Authorization: Basic <Base64-encoded API key and secret>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "lineId": "<UUID of the product ID>",
  "type": "CLIENT_VALIDATION_FAILED",
  "payload": {
    "referrer": "<Referrer URL>",
    "intake": {
      "<Employee count question ID>": {
        "type": "ANSWER",
        "answer": "55",
        "qid": "<Employee count question ID>"
      },
      "<Claims in the last two years question ID>": {
        "type": "ANSWER",
        "answer": "5",
        "qid": "<Claims in the last two years question ID>"
      }
    },
    "clientId": "<UUID of the client ID>",
    "quoteId": "<UUID of the quote request ID>",
    "policyId": "<UUID of the policy ID>",
    "documents": [],
    "intakeLoopIterationIdsToDelete": [],
    "metadata": {
      "validationFailureReason": "OFAC_HIT"
    },
    "integrationData": {
      "externalClientId": "<External client ID>"
    }
  }
}'

{
  "lineId": "<UUID of the product ID>",
  "type": "CLIENT_VALIDATION_FAILED",
  "payload": {
    "referrer": "<Referrer URL>",
    "intake": {
      "<Employee count question ID>": {
        "type": "ANSWER",
        "answer": "55",
        "qid": "<Employee count question ID>"
      },
      "<Claims in the last two years question ID>": {
        "type": "ANSWER",
        "answer": "5",
        "qid": "<Claims in the last two years question ID>"
      }
    },
    "clientId": "<UUID of the client ID>",
    "quoteId": "<UUID of the quote request ID>",
    "policyId": "<UUID of the policy ID>",
    "documents": [],
    "intakeLoopIterationIdsToDelete": [],
    "metadata": {
      "validationFailureReason": "OFAC_HIT"
    },
    "integrationData": {
      "externalClientId": "<External client ID>"
    }
  }
}

Request Fields#

See the shared event envelope. Set type to CLIENT_VALIDATION_FAILED and provide the payload below.

Payload Fields#

Property	Required	Description
`referrer`	No	Optional string value to track a referral.
`intake`	No	Map of question ID to answer object.
`clientId`	No	UUID of the client that failed validation.
`quoteId`	No	UUID of the quote.
`policyId`	No	UUID of the policy.
`documents`	No	List of documents related to the event.
`intakeLoopIterationIdsToDelete`	No	Set of intake loop iteration UUIDs to remove.
`metadata`	No	Additional metadata map.
`integrationData`	No	Integration-specific data map.

Response#

This example illustrates the common trigger response structure. Action counts and metadata depend on the actions that run; action-specific result fields are described where applicable.

{
  "triggerRequestId": "<UUID of the trigger request ID>",
  "executedActionCount": 0,
  "expectedResponseCount": 0,
  "metadata": {}
}

Response Fields#

Property	Description
`triggerRequestId`	UUID identifying this trigger execution.
`executedActionCount`	Number of actions reported as executed.
`expectedResponseCount`	Number of expected action responses.
`metadata`	Action-specific results; may be empty.

See Firing an Event for execution modes and response handling.