Skip to main content
POST
/
api
/
v1
/
report-fraud
curl --request POST \ --url https://sandbox.clausum.ai/api/v1/report-fraud \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "external_transaction_id": "pi_3Nxyz", "provider": "stripe", "reason": "chargeback", "description": "Issuer chargeback received, code 10.4", "ip_address": "201.150.10.22" } '
{
  "success": true,
  "data": {
    "case": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "reference_number": "CLM-LX9A2B",
      "status": "<string>",
      "priority": "<string>"
    },
    "transaction": {
      "id": "<string>",
      "external_id": "<string>",
      "is_fraudulent": true
    },
    "blocklist": {
      "entries_added": 123,
      "types": [
        "<string>"
      ]
    }
  }
}

Authorizations

​
Authorization
string
header
default:clm_sk_your_secret_key
required

Secret API key, e.g. clm_sk_.... Pass it as Authorization: Bearer clm_sk_....

Body

application/json
​
reason
enum<string>
required
Available options:
chargeback,
friendly_fraud,
card_testing,
account_takeover,
identity_theft,
other
​
transaction_id
string

Clausum transaction id, if known.

​
external_transaction_id
string

Provider transaction id (used together with provider).

​
provider
string
Example:

"stripe"

​
amount
number

Required only when no transaction is referenced.

​
currency
string
​
email
string<email>
​
card_bin
string
​
card_last4
string
​
ip_address
string
​
description
string
​
evidence_urls
string<uri>[]
​
notify
object

Response

Fraud report processed

​
success
boolean
​
data
object