Sample - Stripe API
GET/v1/radar/early_fraud_warnings/{early_fraud_warning}

Get an early fraud warning

Retrieves the details of a previously created early fraud warning. Supply the warning identifier and optionally expand related charge or PaymentIntent data in the response.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

2 parameters
early_fraud_warningstringrequired
The unique identifier of the early fraud warning, up to 5,000 characters.
expandarray<string>optional
Fields to expand in the returned early fraud warning; each value can be up to 5,000 characters.

2 status codes
200Returns an early fraud warning object containing its actionability, associated charge, creation time, fraud type, identifier, livemode, object type, and optional PaymentIntent.
actionablebooleanrequired
An EFW is actionable if it has not received a dispute and has not been fully refunded. You may wish to proactively refund a charge that receives an EFW, in order to avoid receiving a dispute later.
chargestringrequired
ID of the charge this early fraud warning is for, optionally expanded.
createdintegerrequired
Time at which the object was created. Measured in seconds since the Unix epoch.
fraud_typestringrequired
The type of fraud labelled by the issuer. One of `card_never_received`, `fraudulent_card_application`, `made_with_counterfeit_card`, `made_with_lost_card`, `made_with_stolen_card`, `misc`, `unauthorized_use_of_card`.
idstringrequired
Unique identifier for the object.
livemodebooleanrequired
If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
objectstringrequired
String representing the object's type. Objects of the same type share the same value.
Allowed:radar.early_fraud_warning
payment_intentstringoptional
ID of the Payment Intent this early fraud warning is for, optionally expanded.
defaultError response.
errorobjectrequired

Error handling

early_fraud_warning must be a string no longer than 5,000 characters identifying an early fraud warning. Each value in expand must be a string no longer than 5,000 characters.