Skip to content

Report an event on a customer evaluation ​

Reports an event on a CustomerEvaluation object.

Returns ​

Returns the CustomerEvaluation object if reporting succeeds.

Parameters ​

  • customer_evaluation (string, required) The ID of the customer evaluation to report the event on.

  • type (enum, required) The type of event to report. Possible enum values:

    • login_failed
    • login_success
    • registration_failed
    • registration_success
  • login_failed (object, optional) Event payload for login_failed.

    • login_failed.reason (enum, required) The reason why this login failed. Possible enum values:
      • other
      • suspected_account_sharing
  • registration_failed (object, optional) Event payload for registration_failed.

    • registration_failed.reason (enum, required) The reason why this registration failed. Possible enum values:
      • other
      • suspected_multi_accounting
  • registration_success (object, optional) Event payload for registration_success.

    • registration_success.customer (string, optional) The ID of a Customer to attach to an entity-less registration evaluation.
curl
curl https://api.stripe.com/v1/radar/customer_evaluations/cuseval_123456789/report \
  -u "<<YOUR_SECRET_KEY>>" \
  -d type=registration_success

Response ​

json
{
  "id": "cuseval_123456789",
  "object": "radar.customer_evaluation",
  "event_type": "registration",
  "livemode": true,
  "created_at": 1715769600,
  "customer": "cus_123456789",
  "events": [
    {
      "type": "registration_success",
      "occurred_at": 1715779600
    }
  ],
  "signals": {
    "multi_accounting": {
      "score": 50.1,
      "evaluated_at": 1715769600,
      "risk_level": null
    }
  }
}

Stripe API Reference - Self-contained docs reference, refreshed 2026-05-18