Preview

Get request

GET
/providers/{providerID}/requests/{requestID}

Fetch one request for payment that you own, with its parties, risk hold, review and assessment links, and recorded operation timeline. A request from another provider and a missing request 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}/requests/{requestID} \
  -u "$MOOV_API_KEY_ID:$MOOV_API_KEY_SECRET" \
  -H "X-Moov-Version: v2026.10.00"
Responses
200 401 403 404
The request completed successfully.
{
  "request": {
    "amount": {
      "currency": {
        "code": "USD",
        "decimalPlaces": 2,
        "name": "US Dollar",
        "numericCode": "840"
      },
      "value": "100.00"
    },
    "assessmentIDs": [
      "ras_01HF5J9ZKQT4RXP8M2VYBN3D"
    ],
    "completedOn": "2026-10-06T14:13:00Z",
    "createdOn": "2026-10-06T14:00:00Z",
    "expiresOn": "2026-10-16T14:00:00Z",
    "fundedOn": "2026-10-06T14:12:00Z",
    "hold": {
      "active": true,
      "expiresOn": "2026-10-06T17:00:00Z"
    },
    "memo": "Dinner last Friday",
    "operations": [
      {
        "externalReference": "aft-transfer-id",
        "failureCode": "denied",
        "occurredOn": "2026-10-06T15:00:01Z",
        "operationID": "op_01HF5J9ZKQT4RXP8M2VYBN3D",
        "rail": "aft",
        "status": "succeeded",
        "type": "collect"
      }
    ],
    "payer": {
      "displayName": "Jane Doe",
      "externalID": "C-2077",
      "funding": {
        "displayName": "Checking",
        "fundingType": "bank_account",
        "last4": "5612"
      },
      "participantID": "counterparty-id_user",
      "phoneNumber": "+15555551234"
    },
    "referenceNumber": "7K2Q9X4FC",
    "requestID": "01HF5J9ZKQT4RXP8M2VYBN3D_req",
    "requester": {
      "displayName": "Jane Smith",
      "externalID": "C-1042",
      "funding": {
        "displayName": "Checking",
        "fundingType": "bank_account",
        "last4": "5612"
      },
      "participantID": "participant-id_user"
    },
    "reviewIDs": [
      "prv_01HF5J9ZKQT4RXP8M2VYBN3D"
    ],
    "status": "created"
  }
}
Authentication missing, invalid, or insufficient.
Authentication present but the action is forbidden for this principal/claim.
The requested resource was not found.

Headers

X-Moov-Version

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

Path parameters

providerID

string required
Your provider account ID.

requestID

string required
Identifier of the request.

Response

Response envelope for GET /providers/{providerID}/requests/{requestID}; the request is nested under request.

request

object required
The request detail.
Show child attributes

request

requestID

string required
Unique system-assigned request identifier.

referenceNumber

string required
Short support reference for the request.

amount

object required
Request amount and currency.
Show child attributes

request.amount

value

string required
Decimal amount as a string.

currency

object required
ISO 4217 currency descriptor.
Show child attributes

request.amount.currency

code

string required
Uppercase 3-letter ISO 4217 currency code.

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.

memo

string
Free-form note shown to the payer on the landing page.

status

string<enum> required
Current lifecycle status of the request.
Possible values: created, authenticated, declined, cancelled, expired, paying, funded, disbursing, disbursement_failed, completed, reversing, reversal_failed, reversed, denied

requester

object required
The participant who created the request.
Show child attributes

request.requester

participantID

string required
The initiator’s participant ID.

externalID

string
Your external ID for the initiator.

displayName

string
The initiator’s current name (given + family). Omitted when unknown.

funding

object
The initiator’s instrument for this payment: the funding source a payout sends from, or the funding destination a request pays into. Omitted until the instrument is known.
Show child attributes

request.requester.funding

fundingType

string<enum> required
Instrument discriminator.
Possible values: card, bank_account

displayName

string
Human-readable display label, such as the account nickname or card brand. Omitted when unknown.

last4

string
Last four digits of the card number for card, or of the bank account number for bank_account. Omitted when unknown. At most 4 characters.

payer

object required
The payer. Only the addressed phone is known until a payer authenticates; an open request has none.
Show child attributes

request.payer

displayName

string
Counterparty display name (given + family) when known.

phoneNumber

string
Counterparty phone number in E.164 form when known.

participantID

string
The party’s participant ID, once the party is bound to the payment. Omitted for an unbound party, such as the recipient of an unclaimed payout or the payer of an open request. The ID does not give access to the record of a participant that is not yours.

externalID

string
Your external ID for the party. Present only when the party is your participant.

funding

object
The instrument the party used for this payment. Omitted until the instrument is known.
Show child attributes

request.payer.funding

fundingType

string<enum> required
Instrument discriminator.
Possible values: card, bank_account

displayName

string
Human-readable display label, such as the account nickname or card brand. Omitted when unknown.

last4

string
Last four digits of the card number for card, or of the bank account number for bank_account. Omitted when unknown. At most 4 characters.

hold

object required
The current risk hold on the request.
Show child attributes

request.hold

active

boolean required
Whether a risk restriction blocks the payment now.

expiresOn

string<date-time>
When the blocking restriction ends: the latest expiry among the reviews that block the payment. Omitted when active is false, and when any blocking review has no expiry.

reviewIDs

array<string> required
The payment reviews opened for this request, oldest first. Empty when none exist.

assessmentIDs

array<string> required
The risk assessments recorded for this request, oldest first. Empty when none exist.

operations

array<object> required
The recorded money movements of the request, oldest first: each pay attempt, the disbursement, and any refund. Empty before the first pay attempt.
Show child attributes

request.operations[]

operationID

string required
Identifier of the operation.

type

string<enum> required
The money movement the operation performs.
Possible values: collect, authorize, capture, release, disburse, refund

rail

string<enum> required
The external system that moves the money.
Possible values: aft, oct, core_hold, core_credit

status

string<enum> required
Current status of the operation.
Possible values: reserved, pending, succeeded, failed, unknown

occurredOn

string<date-time> required
When the operation reached its current status: the resolution time for succeeded and failed, otherwise the time of the latest recorded change.

externalReference

string
The reference that the rail returned: the Moov transfer ID of an aft or oct operation, or the hold, release, capture, or credit reference that your ledger returned for a core_hold or core_credit operation. rail identifies the kind. A ledger reference is not a transfer ID. Omitted until the rail returns one.

failureCode

string
Machine-readable code for the latest failure. Can be present when status is failed, and while Moov Money retries the call. Omitted when no failure was recorded. Treat an unknown value as opaque.

createdOn

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

expiresOn

string<date-time> required
Timestamp when the request expires and can no longer be paid.

fundedOn

string<date-time>
Timestamp when the pay-in completed. Present only once the request is funded.

completedOn

string<date-time>
Timestamp when disbursement settled. Present only when the request has completed.