Early fraud warnings

An early fraud warning tells the store that a card issuer reported one of its charges as likely fraud, before any dispute. A warning with actionable true still leaves time to refund the charge in full and avoid the dispute and its fee; a full refund makes the warning actionable false. Warnings are read-only and name the store's own charge and PaymentIntent; each new warning is also sent as radar.early_fraud_warning.created, and each change as radar.early_fraud_warning.updated (see Events).

Send every request to https://api.fluveo.com/v1 with your secret key as a Bearer token. This page lists only what Fluveo serves; the OpenAPI file holds the same operations.

An operation or a parameter marked Preview works, but it is not locked yet and may change: what Preview means.

Lists the store's early fraud warnings, newest firstPreview#

GET/v1/radar/early_fraud_warningsNo restricted key

Preview: this operation works, but it is not locked yet; it may change.

Query parameters

chargestringOptional
Only the warnings of this charge. A charge id that is not the store's is refused with 404 resource_missing.
createdobjectOptional
Filter on the creation time, a Unix timestamp: created=<t> for an exact match, or created[gt], created[gte], created[lt], created[lte].
ending_beforestringOptional
Cursor: the id of the first object of the current page, to get the previous page. Do not send it with starting_after.
limitintegerOptional
How many objects to return, from 1 to 100. Default 10.
payment_intentstringOptional
Only the warnings of this PaymentIntent's charges. A PaymentIntent id that is not the store's is refused with 404 resource_missing.
starting_afterstringOptional
Cursor: the id of the last object of the previous page, to get the next page. Do not send it with ending_before.

Headers

Fluveo-VersionenumOptional
Optional. The only version Fluveo serves is 2026-05-27.dahlia; any other value is refused with a 400. Every answer names that version in its own Fluveo-Version header, except the refusals Fluveo gives before it reads the request (no key, an unknown key, an unknown URL, a body that is not a form) and a file's bytes, which name no version and no Request-Id.

One of: 2026-05-27.dahlia.

Returns a list of radar.early_fraud_warning objects.

Request

curl https://api.fluveo.com/v1/radar/early_fraud_warnings \
  -H "Authorization: Bearer sk_test_..."

const response = await fetch("https://api.fluveo.com/v1/radar/early_fraud_warnings", {
  method: "GET",
  headers: {
    "Authorization": "Bearer sk_test_...",
  },
});
console.log(await response.json());

import requests

response = requests.get(
    "https://api.fluveo.com/v1/radar/early_fraud_warnings",
    headers={"Authorization": "Bearer sk_test_..."},
)
print(response.json())

<?php
$ch = curl_init("https://api.fluveo.com/v1/radar/early_fraud_warnings");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer sk_test_...",
    ],
]);
echo curl_exec($ch);

Retrieves one early fraud warningPreview#

GET/v1/radar/early_fraud_warnings/{early_fraud_warning}No restricted key

Preview: this operation works, but it is not locked yet; it may change.

Path parameters

early_fraud_warningstringRequired
The id of the radar.early fraud warning.

Headers

Fluveo-VersionenumOptional
Optional. The only version Fluveo serves is 2026-05-27.dahlia; any other value is refused with a 400. Every answer names that version in its own Fluveo-Version header, except the refusals Fluveo gives before it reads the request (no key, an unknown key, an unknown URL, a body that is not a form) and a file's bytes, which name no version and no Request-Id.

One of: 2026-05-27.dahlia.

Returns a radar.early_fraud_warning object.

Request

curl https://api.fluveo.com/v1/radar/early_fraud_warnings/issfr_123 \
  -H "Authorization: Bearer sk_test_..."

const response = await fetch("https://api.fluveo.com/v1/radar/early_fraud_warnings/issfr_123", {
  method: "GET",
  headers: {
    "Authorization": "Bearer sk_test_...",
  },
});
console.log(await response.json());

import requests

response = requests.get(
    "https://api.fluveo.com/v1/radar/early_fraud_warnings/issfr_123",
    headers={"Authorization": "Bearer sk_test_..."},
)
print(response.json())

<?php
$ch = curl_init("https://api.fluveo.com/v1/radar/early_fraud_warnings/issfr_123");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer sk_test_...",
    ],
]);
echo curl_exec($ch);

The radar.early_fraud_warning object#

Ids start with issfr_.

Attributes

actionableboolean
chargestringExpandable
An id by default; send expand[]=charge to get the full charge object.
createdinteger
fraud_typestring
idstring
livemodeboolean
objectenum
One of: radar.early_fraud_warning.
payment_intentstringExpandable
An id by default; send expand[]=payment_intent to get the full payment_intent object.