Get provider review

GET
/providers/{providerID}/reviews/{reviewID}

Fetch one payout review, including the full nested payout detail and the signals the authorize call carries: sender external ID, funding source, and fraud score. A review from another provider and a missing review both return 404.

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

Request
cURL
curl -X GET https://api.moov.money/providers/{providerID}/reviews/{reviewID}
Responses
200 401 404
The request completed successfully.
{
  "review": {
    "createdOn": "2026-08-31T12:00:00Z",
    "fraudScore": 0.82,
    "fundingSource": "src_01HF5J9ZKQT4RXP8M2VYBN3D",
    "payout": {
      "amount": {
        "currency": {
          "code": "USD",
          "decimalPlaces": 2,
          "name": "US Dollar",
          "numericCode": "840"
        },
        "value": "100.00"
      },
      "fundedFrom": {
        "fundingType": "aft",
        "reference": "mmr-abc-123"
      },
      "payoutID": "pay_01HF5J9ZKQT4RXP8M2VYBN3D",
      "phone": {
        "countryCode": "1",
        "number": "5555550101"
      },
      "providerID": "acc_01HF5J9ZKQT4RXP8M2VYBN3D",
      "referenceNumber": "7K2Q9X4FC",
      "status": "initiated"
    },
    "reason": "Payout amount above review threshold",
    "resolutionNotes": "Verified account holder",
    "reviewID": "prv_01HF5J9ZKQT4RXP8M2VYBN3D",
    "reviewStatus": "pending",
    "riskAssessmentID": "ras_01HF5J9ZKQT4RXP8M2VYBN3D",
    "senderExternalID": "customer-abc-123"
  }
}
Authentication missing, invalid, or insufficient.
The requested resource was not found.

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.

reviewID

string required
Identifier of the review.

Response

Response envelope for get review; the review is nested under review.

review

object required
The full review detail.
Show child attributes

review

reviewStatus

string<enum> required
Current review status. Serialized as reviewStatus on the wire.
Possible values: pending, approved, rejected

reason

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

riskAssessmentID

string
Risk assessment that produced this review, when available.

senderExternalID

string required
Sender’s external ID: your identifier for the participant sending the payout.

fundingSource

string required
Provider-issued token identifying the funding source the payout draws from. Opaque to Moov Money.

fraudScore

number<float> required
Fraud score from the check that produced this review, 0.0 to 1.0. Higher means riskier.

resolvedBy

string
Subject that resolved the review. Omitted while pending.

resolutionNotes

string
Free-form notes supplied at resolution. Omitted when empty.

payout

object required
Full payout detail for the reviewer’s decision.
Show child attributes

review.payout

providerID

string required
Moov account ID of the provider that created the payout.

amount

object required
Payout amount and currency.
Show child attributes

review.payout.amount

currency

object required
ISO 4217 currency descriptor.
Show child attributes

review.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.

memo

string
Free-form note shown to the recipient on the claim page.

phone

object
Recipient’s phone, if provided at creation. Omitted when the payout has no recipient phone.
Show child attributes

review.payout.phone

number

string required
National significant number without the country calling code. ASCII digits only.

countryCode

string required
ITU country calling code without a leading plus. ASCII digits only.

recipientGivenName

string
Recipient’s given (first) name. Present only after the recipient has claimed the payout.

recipientFamilyName

string
Recipient’s family (last) name. Present only after the recipient has claimed the payout.

status

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

createdOn

string<date-time> required
Timestamp when the payout was created.

code

string required
Opaque claim code embedded in the landing URL.

referenceNumber

string required
Short, human-readable support reference. A participant can read it aloud to their support or paste it into a ticket. It is not a secret and does not open the claim flow; the claim code does that.

link

string required
Full claim landing URL to deliver to the recipient.

expiresOn

string<date-time> required
Timestamp when the payout expires and can no longer be claimed. Always present.

claimedAt

string<date-time>
Timestamp when the recipient initiated the payout claim. Present only once the payout has been claimed; omitted otherwise.

completedOn

string<date-time>
Timestamp when the payout transfer settled. Present only when the payout has completed; omitted otherwise.

fundedFrom

object
Display-only projection of the latest approved funding attempt. Omitted when no approved attempt exists yet (eventually consistent). Absent from list and cancel responses.
Show child attributes

review.payout.fundedFrom

reference

string
Money movement reference for the approved attempt, when projected. Omitted when the ref has not yet been written.

fundingType

string<enum> required
Funding model used for the approved attempt.
Possible values: aft, core_ledger, unknown

sender

object
Sender attributes echoed from the create request. Omitted when unavailable.
Show child attributes

review.payout.sender

fundingSource

string required
Identifier of the funding source used for this payout, as supplied at creation.

payoutID

string required
Unique system-assigned payout identifier.

createdOn

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

resolvedOn

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

reviewID

string required
Unique system-assigned review identifier.