🚧
Account configuration is required before testing transactions
If you are interested in access to this feature, please contact support@paymongo.com!

Retrieves a paginated list of all Review resources created by the fraud detection system. Each review represents a transaction that was flagged for manual investigation due to matching a custom rule or receiving a medium/high risk score.

This endpoint allows you to monitor all suspicious payments, track their review status, and obtain relevant details such as risk score, reason for flagging, and associated payment intent. Use this endpoint to power review dashboards or automate further analysis of flagged transactions.

Notes: If you do not specify the dates when calling this endpoint, it will default to the last 7 days.

Example Response

{
  "has_more": false,
  "data": [
    {
      "id": "frr_abcdefg123456",
      "type": "fraud.review",
      "score": 535,
      "risk_level": "medium",
      "organization_id": "org_abcdefg123456",
      "payment_intent_id": "pi_abcdefg123456",
      "score_id": "frs_abcdefg123456",
      "customer_email": "john@example.com",
      "payment_id": "pay_abcdefg123456",
      "livemode": true,
      "closed": false,
      "reason": "rule",
      "rule_id": "frl_abcdefg123456",
      "opened_reason": "rule",
      "closed_reason": null,
      "created_at": "2025-06-27T01:46:09.314Z",
      "updated_at": null
    }
  ]
}

attribute	description
`id`	Unique ID of the Review resource
`type`	Resource type (`fraud.review`)
`score`	Risk score assigned to the transaction (0–1000)
`risk_level`	Risk level classification (`low`, `medium`, `high`)
`organization_id`	ID of the organization that owns the review
`payment_intent_id`	ID of the associated payment intent
`payment_id`	ID of the associated payment
`customer_email`	Customer's email address used in billing information
`score_id`	ID of the associated fraud score. See Scores documentation
`livemode`	Whether the review occurred in live mode (`true` or `false`)
`closed`	Whether the review has been closed
`reason`	The trigger for the review (e.g., `rule`)
`rule_id`	ID of the rule that triggered the review
`opened_reason`	Reason why the review was opened
`closed_reason`	Reason why the review was closed (if closed)
`created_at`	Timestamp when the review was created (ISO8601)
`updated_at`	Timestamp when the review was last updated