---
title: "List Reviews"
method: GET
path: "/v1/reviews"
tags: ["Reviews"]
---

# List Reviews

`GET /v1/reviews`

Returns a list of your fraud reviews, newest-first.

Use the `open` filter to focus on reviews that still need action.

## Query parameters

- `open` boolean, nullable — Filter by review state. `true` returns only open reviews, `false` returns only closed. Omit to return both.
- `charge_id` string, nullable — Filter to reviews on a specific charge.
- `payment_intent_id` string, nullable — Filter to reviews on a specific payment intent.
- `client_reference_id` string, nullable — Filter by `client_reference_id` (matches your own identifier on the underlying checkout session, when present).
- `starting_after` string, nullable — Cursor for forward pagination — review id from a previous page.
- `ending_before` string, nullable — Cursor for backward pagination.
- `limit` integer, nullable — Page size, between 1 and 100. Default 20.

## Response `200`

An envelope wrapping a list of review objects.

- MultipleReviewsBodyForReview — An envelope wrapping a list of review objects.
  - `reviews` Review[], required — The list of reviews.
    - `review_id` string, required — Unique identifier for the review, prefixed with `frv_`.
    - `charge_id` string, nullable — ID of the Charge under review, prefixed with `fch_`. `null` if the review is not associated with a specific charge.
    - `payment_intent_id` string, nullable — ID of the Payment Intent under review, prefixed with `fpi_`. `null` if the review is not associated with a specific payment intent.
    - `partner_id` string, required — ID of the account that owns the payment under review, prefixed with `facct_`.
    - `reason` 'rule' | 'manual' | 'approved' | 'refunded' | 'refunded_as_fraud' | 'disputed' | 'redacted', required — Why the review is currently open or closed.
    - `opened_reason` 'rule' | 'manual', required — Why the review was opened.
    - `closed_reason` 'approved' | 'disputed' | 'redacted' | 'refunded' | 'refunded_as_fraud' — Why the review was closed.
    - `open` boolean, required — Whether the review is still open. `true` while the payment is under review, `false` once it has been resolved.
    - `billing_zip` string, nullable — Billing ZIP/postal code provided for the payment under review. Omitted if not available.
    - `ip_address` string, nullable — IP address from which the payment under review was made. Omitted if not available.
    - `test_mode` boolean, required — Whether this review was created in test mode. `true` for test-mode data, `false` for live data.
    - `client_reference_id` string, nullable — Your own identifier for the payment under review, carried over from the originating checkout session or payment. Omitted if none was set.
    - `created_at` string, required — A timestamp encoded as an RFC 3339 / ISO 8601 string (e.g. `2026-06-15T14:30:00Z`).

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Validation Error
- `429` — Too Many Requests

---

[API](https://skmtc.dev/withflex/apis/flex-api.md) · [All operations](https://skmtc.dev/withflex/apis/flex-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/withflex/flex-api/revisions/b1560fc2f199/schema)