List provider reviews

GET
/providers/{providerID}/reviews

List the payout reviews scoped to your provider, newest first. Reviews from other providers are never returned. Returns an empty list when none match.

status defaults to pending, the active review queue.

Pagination is cursor-based. Omit cursor to fetch the first page; use nextCursor from each response to fetch the next page.

Auth: API key or bearer token. Scoped to the calling provider.

Request
cURL
curl -X GET https://api.moov.money/providers/{providerID}/reviews
Responses
200 400 401
The request completed successfully.
{
  "reviews": [
    {
      "createdOn": "2026-08-31T12:00:00Z",
      "payout": {
        "amount": {
          "currency": {
            "code": "USD",
            "decimalPlaces": 2,
            "name": "US Dollar",
            "numericCode": "840"
          },
          "value": "100.00"
        },
        "payoutID": "pay_01HF5J9ZKQT4RXP8M2VYBN3D",
        "recipientName": "Jane Doe",
        "status": "initiated"
      },
      "reason": "Payout amount above review threshold",
      "reviewID": "prv_01HF5J9ZKQT4RXP8M2VYBN3D",
      "riskAssessmentID": "ras_01HF5J9ZKQT4RXP8M2VYBN3D",
      "status": "pending"
    }
  ]
}
Malformed request: the body or headers failed validation.
Authentication missing, invalid, or insufficient.

Headers

X-Moov-Version

string
Set this header to the API version being targeted (e.g. v2026.07.00). When omitted, the server applies its default version.

Path parameters

providerID

string required
Your provider account ID.

Query parameters

status

string
Filter by review status. Defaults to pending when omitted; unrecognized values return 400.
Possible values: pending, approved, rejected

cursor

string
Opaque pagination cursor from a previous response’s nextCursor. Omit to fetch the first page.

limit

integer <int32>
Maximum number of reviews to return. Defaults to 25; values outside 1-100 return 400.

Response

Response envelope for list reviews.

nextCursor

string
Opaque cursor for the next page; absent on the last page.

hasMore

boolean required
Whether another page of results follows this one.

reviews

array<object> required
The page of review summaries, newest first.
Show child attributes

reviews[]

createdOn

string<date-time>
When the review was created.

payout

object
Payout summary for the queue.
Show child attributes

reviews[].payout

amount

object required
Payout amount and currency.
Show child attributes

reviews[].payout.amount

currency

object required
ISO 4217 currency descriptor.
Show child attributes

reviews[].payout.amount.currency

decimalPlaces

integer<uint8> required
Number of minor-unit decimal places for code. Required.

numericCode

string
ISO 4217 numeric currency code, if known. Informational only.

name

string
Human-readable currency name, if known. Informational only.

code

string required
Uppercase 3-letter ISO 4217 currency code.

value

string required
Decimal amount as a string.

recipientName

string
Recipient display name when known (given + family), otherwise omitted.

status

string<enum> required
Current lifecycle status of the payout.
Possible values: initiated, authorized, accepted, claiming, completed, failed, payout_failed, cancelled, expired, denied

payoutID

string required
Unique system-assigned payout identifier.

reason

string
Human-readable reason the payout was placed in review.

resolvedOn

string<date-time>
When the review was resolved. Omitted while pending.

reviewID

string
Unique system-assigned review identifier.

riskAssessmentID

string
Risk assessment that produced this review, when available.

status

string<enum>
Current review status.
Possible values: pending, approved, rejected