Score Resource

Represent a Score resource for each transaction

🚧

Beta testing phase

This is not the final version of the product, and is still subject to change.

If you are interested in early access to this feature, please contact [email protected]!

A Score resource

{
  "has_more": false,
  "data": [
    {
      "id": "frs_ABCDEFGHIJ123456780",
      "type": "fraud.score",
      "livemode": true,
      "score": 900,
      "external_id": "ORD-20210818-001",
      "external_attribute_name": "order_id",
      "organization_id": "org_123456789",
      "decision_reason": "high_risk",
      "decision": "fraud",
      "created_at": "2025-08-18T10:30:33Z",
      "updated_at": null
    },
    {
      "id": "frs_ABCDEFGHIJ123456781",
      "type": "fraud.score",
      "livemode": true,
      "score": 100,
      "external_id": "ORD-20210818-002",
      "external_attribute_name": "order_id",
      "organization_id": "org_123456789",
      "decision_reason": "low_risk",
      "decision": "legit",
      "created_at": "2025-08-18T10:30:33Z",
      "updated_at": null
    }
  ]
}

AttributeTypeDescription
idstringUnique ID of the score resource
typestringResource type (fraud.score)
scoreintegerRisk score (0–1000)
external_idstringUnique reference for the transaction in your system
external_attribute_namestringName/type of the external ID (e.g., order_id, invoice_id)
organization_idstringOrganization that owns the score
decision_reasonstringReason for the assigned decision (high_risk, low_risk, etc.)
decisionstringFinal decision (fraud or legit)
livemodebooleanIndicates if the score is for live or test mode
created_atstringTimestamp when the score was created (ISO8601)
updated_atstringTimestamp when the score was last updated