Get transfer events timeline
Retrieve the complete ordered event timeline for a Transfer.
Events are returned oldest to newest by occurrence time, with deterministic ordering when multiple events have the same occurrence time. An existing Transfer with no stored events returns an empty list.
To access this endpoint using an access token
you'll need to specify the /accounts/{accountID}/transfers.read scope.
curl -X GET "https://api.moov.io/accounts/{accountID}/transfers/{transferID}/events" \
-H "Authorization: Bearer {token}" \
-H "X-Moov-Version: v2026.10.00"[
{
"eventID": "hvqfkbxkubnp3mz4gzq4fblzha_xfevt",
"eventType": "transfer",
"amount": {
"currency": "USD",
"valueDecimal": "50.00"
},
"details": {
"transfer": {
"status": "created"
}
},
"occurredOn": "2026-08-25T17:00:00Z"
},
{
"eventID": "mzn7cpxf5rnlrfr42tu7g4jl4a_xfevt",
"eventType": "transfer",
"amount": {
"currency": "USD",
"valueDecimal": "50.00"
},
"details": {
"transfer": {
"status": "pending"
}
},
"occurredOn": "2026-08-25T17:00:01Z"
},
{
"eventID": "gtbjhsrhcjkfrnkj7ofx7dvj4y_xfevt",
"eventType": "wallet-debit",
"amount": {
"currency": "USD",
"valueDecimal": "50.00"
},
"details": {
"walletDebit": {
"accountID": "34233b72-780c-4a0d-8b08-cbbe238878f8",
"walletID": "d952df60-ef94-4954-b7fe-59a03566f4f7",
"transactionID": "47d89793-c280-4869-b7aa-a2a0bfe6b5db",
"transactionType": "cash-out"
}
},
"occurredOn": "2026-08-25T17:00:02Z"
},
{
"eventID": "nqq53qymozlmtdk6cwv7mwmehm_xfevt",
"eventType": "instant-bank-credit",
"amount": {
"currency": "USD",
"valueDecimal": "50.00"
},
"details": {
"instantBankCredit": {
"status": "initiated"
}
},
"occurredOn": "2026-08-25T17:00:03Z"
},
{
"eventID": "f4dr3wqxtzoxhfztp4diyx7gya_xfevt",
"eventType": "instant-bank-credit",
"amount": {
"currency": "USD",
"valueDecimal": "50.00"
},
"details": {
"instantBankCredit": {
"status": "accepted-without-posting"
}
},
"occurredOn": "2026-08-25T17:00:04Z"
},
{
"eventID": "v4ufgp3t6zp3nhwwmcx22kp7jq_xfevt",
"eventType": "instant-bank-credit",
"amount": {
"currency": "USD",
"valueDecimal": "50.00"
},
"details": {
"instantBankCredit": {
"status": "completed"
}
},
"occurredOn": "2026-08-25T17:00:05Z"
},
{
"eventID": "ddigcwbagfmfnaosoykg7ti4qi_xfevt",
"eventType": "transfer",
"amount": {
"currency": "USD",
"valueDecimal": "50.00"
},
"details": {
"transfer": {
"status": "completed"
}
},
"occurredOn": "2026-08-25T17:00:06Z"
}
][
{
"eventID": "dpnxjpr2ozorjewn7pawbvqyzi_xfevt",
"eventType": "transfer",
"amount": {
"currency": "USD",
"valueDecimal": "100.00"
},
"details": {
"transfer": {
"status": "created"
}
},
"occurredOn": "2026-08-25T16:00:00Z"
},
{
"eventID": "q43iytyb6jnirjkww4c4waxq4i_xfevt",
"eventType": "authorization",
"amount": {
"currency": "USD",
"valueDecimal": "100.00"
},
"details": {
"authorization": {
"authorizationID": "twkx2my2tjd2vfda7ynjb4ad3u_auth",
"status": "approved"
}
},
"occurredOn": "2026-08-25T16:00:01Z"
},
{
"eventID": "4zbyazy7ifiz3hiv3b5sluuviy_xfevt",
"eventType": "transfer",
"amount": {
"currency": "USD",
"valueDecimal": "100.00"
},
"details": {
"transfer": {
"status": "awaiting-capture"
}
},
"occurredOn": "2026-08-25T16:00:02Z"
},
{
"eventID": "jy3cl4ujsjlzbl4y3moh46khme_xfevt",
"eventType": "capture",
"amount": {
"currency": "USD",
"valueDecimal": "100.00"
},
"details": {
"capture": {
"captureID": "67u5hqjljjgi5hy2nvnty7uksa_capt",
"status": "pending"
}
},
"occurredOn": "2026-08-25T16:01:00Z"
},
{
"eventID": "w4qur7yzgroehpgb67evhvpy5y_xfevt",
"eventType": "capture",
"amount": {
"currency": "USD",
"valueDecimal": "100.00"
},
"details": {
"capture": {
"captureID": "67u5hqjljjgi5hy2nvnty7uksa_capt",
"status": "completed"
}
},
"occurredOn": "2026-08-25T16:01:01Z"
},
{
"eventID": "75wjqe2gtbptpazmcpt2qtpc4e_xfevt",
"eventType": "wallet-credit",
"amount": {
"currency": "USD",
"valueDecimal": "100.00"
},
"details": {
"walletCredit": {
"accountID": "34233b72-780c-4a0d-8b08-cbbe238878f8",
"walletID": "d952df60-ef94-4954-b7fe-59a03566f4f7",
"transactionID": "21aa7280-945b-492d-8d71-04a5a41d16e4",
"transactionType": "payment",
"captureID": "67u5hqjljjgi5hy2nvnty7uksa_capt"
}
},
"occurredOn": "2026-08-25T16:01:02Z"
},
{
"eventID": "bocpocugz5pfzi3jz7nwacvvxa_xfevt",
"eventType": "transfer",
"amount": {
"currency": "USD",
"valueDecimal": "100.00"
},
"details": {
"transfer": {
"status": "completed"
}
},
"occurredOn": "2026-08-25T16:01:03Z"
}
][
{
"eventID": "stakolxnwbpezjoilq3nusvkzu_xfevt",
"eventType": "transfer",
"amount": {
"currency": "USD",
"valueDecimal": "100.00"
},
"details": {
"transfer": {
"status": "created"
}
},
"occurredOn": "2026-08-25T15:00:00Z"
},
{
"eventID": "owxbm2x2r5n7dhiq4pq3k6bxwy_xfevt",
"eventType": "card-payment",
"amount": {
"currency": "USD",
"valueDecimal": "100.00"
},
"details": {
"cardPayment": {
"status": "initiated"
}
},
"occurredOn": "2026-08-25T15:00:01Z"
},
{
"eventID": "soylnzxq7bjjjepixwjc5qvmla_xfevt",
"eventType": "card-payment",
"amount": {
"currency": "USD",
"valueDecimal": "100.00"
},
"details": {
"cardPayment": {
"status": "completed"
}
},
"occurredOn": "2026-08-25T15:00:02Z"
},
{
"eventID": "sumatzx5zzpchcxihsmru2hfnm_xfevt",
"eventType": "wallet-credit",
"amount": {
"currency": "USD",
"valueDecimal": "100.00"
},
"details": {
"walletCredit": {
"accountID": "34233b72-780c-4a0d-8b08-cbbe238878f8",
"walletID": "d952df60-ef94-4954-b7fe-59a03566f4f7",
"transactionID": "882b9983-9b15-470f-8e5c-27f142459688",
"transactionType": "payment"
}
},
"occurredOn": "2026-08-25T15:00:03Z"
},
{
"eventID": "pisl6tyf2nm43g5ppnkcjinqvq_xfevt",
"eventType": "transfer",
"amount": {
"currency": "USD",
"valueDecimal": "100.00"
},
"details": {
"transfer": {
"status": "completed"
}
},
"occurredOn": "2026-08-25T15:00:04Z"
},
{
"eventID": "trzo5ocuajnwnolifxgay4ejpu_xfevt",
"eventType": "refund",
"amount": {
"currency": "USD",
"valueDecimal": "25.00"
},
"details": {
"refund": {
"refundID": "e84f4682-7bf5-45a0-9e8f-34658217fb93",
"status": "created"
}
},
"occurredOn": "2026-08-25T15:05:00Z"
},
{
"eventID": "vmvfg3ccyjpvbbklpjjbgjtqku_xfevt",
"eventType": "refund",
"amount": {
"currency": "USD",
"valueDecimal": "25.00"
},
"details": {
"refund": {
"refundID": "e84f4682-7bf5-45a0-9e8f-34658217fb93",
"status": "completed"
}
},
"occurredOn": "2026-08-25T15:05:01Z"
},
{
"eventID": "6wv3tjeb6bpfbbz63dyz6i4l2e_xfevt",
"eventType": "wallet-debit",
"amount": {
"currency": "USD",
"valueDecimal": "25.00"
},
"details": {
"walletDebit": {
"accountID": "34233b72-780c-4a0d-8b08-cbbe238878f8",
"walletID": "d952df60-ef94-4954-b7fe-59a03566f4f7",
"transactionID": "6c4a190c-d968-4f4e-8bd7-16bed031eea7",
"transactionType": "refund"
}
},
"occurredOn": "2026-08-25T15:05:02Z"
}
][
{
"eventID": "ns2eh7abvvjv3llz7dwklgo7tu_xfevt",
"eventType": "transfer",
"amount": {
"currency": "USD",
"valueDecimal": "100.00"
},
"details": {
"transfer": {
"status": "pending"
}
},
"occurredOn": "2026-08-25T14:00:00Z"
},
{
"eventID": "lgplcwrtejix5bfoxym5sbn4uy_xfevt",
"eventType": "ach-debit",
"amount": {
"currency": "USD",
"valueDecimal": "100.00"
},
"details": {
"achDebit": {
"status": "initiated"
}
},
"occurredOn": "2026-08-25T14:00:01Z"
},
{
"eventID": "2eujpmsezbo2dfqsauwm6vsjqe_xfevt",
"eventType": "ach-debit",
"amount": {
"currency": "USD",
"valueDecimal": "100.00"
},
"details": {
"achDebit": {
"status": "completed"
}
},
"occurredOn": "2026-08-25T14:00:02Z"
},
{
"eventID": "2bt3eg7khziuvkwvrpfgbr6bmm_xfevt",
"eventType": "ach-credit",
"amount": {
"currency": "USD",
"valueDecimal": "100.00"
},
"details": {
"achCredit": {
"status": "initiated"
}
},
"occurredOn": "2026-08-25T14:00:03Z"
},
{
"eventID": "2cefzpmzqzp2blzqdpjbk2p3ou_xfevt",
"eventType": "ach-credit",
"amount": {
"currency": "USD",
"valueDecimal": "100.00"
},
"details": {
"achCredit": {
"status": "completed"
}
},
"occurredOn": "2026-08-25T14:00:04Z"
},
{
"eventID": "uww2s3fd3vnvtcbd4wyh7vxpou_xfevt",
"eventType": "transfer",
"amount": {
"currency": "USD",
"valueDecimal": "100.00"
},
"details": {
"transfer": {
"status": "completed"
}
},
"occurredOn": "2026-08-25T14:00:05Z"
},
{
"eventID": "2hlvny5xbvoddagp27onxermj4_xfevt",
"eventType": "ach-debit",
"amount": {
"currency": "USD",
"valueDecimal": "100.00"
},
"details": {
"achDebit": {
"status": "returned"
}
},
"occurredOn": "2026-08-25T14:05:00Z"
},
{
"eventID": "rolfxjseibjolp5gqenmpx3a4a_xfevt",
"eventType": "wallet-debit",
"amount": {
"currency": "USD",
"valueDecimal": "100.00"
},
"details": {
"walletDebit": {
"accountID": "7e4b26c2-b399-49ef-8390-50e1ea44d550",
"walletID": "4a1e1e9b-e711-42cb-9558-dad3e40d9e3c",
"transactionID": "fffee6fa-7359-4a96-9c95-f09df39f139d",
"transactionType": "ach-reversal"
}
},
"occurredOn": "2026-08-25T14:05:01Z"
},
{
"eventID": "rkirb4ummrokbnhrknhh7srx6q_xfevt",
"eventType": "transfer",
"amount": {
"currency": "USD",
"valueDecimal": "100.00"
},
"details": {
"transfer": {
"status": "reversed"
}
},
"occurredOn": "2026-08-25T14:05:02Z"
}
]Response headers
x-request-id
string
required
Response headers
x-request-id
string
required
Response headers
x-request-id
string
required
Response headers
x-request-id
string
required
Response headers
x-request-id
string
required
Response headers
x-request-id
string
required
Response headers
x-request-id
string
required
Headers
X-Moov-Version
string
v2026.08.00 uses v2026.07.00.
A malformed value, such as 2022, returns a 404 response.
v2026.10.00
Path parameters
accountID
string
required
transferID
string
required
Response
amount
object
Show child attributes
amount
currency
string
required
Pattern
valueDecimal
string
required
Pattern
A decimal-formatted numerical string that represents up to 9 decimal place precision.
For example, $12.987654321 is '12.987654321'.
details
object
Show child attributes
details
achCredit
object
Show child attributes
details.achCredit
status
string<enum>
required
,
initiated,
originated,
corrected,
returned,
completed,
canceled
correction
object
Show child attributes
details.achCredit.correction
code
string
description
string
reason
string
return
object
Show child attributes
details.achCredit.return
code
string
description
string
reason
string
achDebit
object
Show child attributes
details.achDebit
status
string<enum>
required
,
initiated,
originated,
corrected,
returned,
completed,
canceled
correction
object
Show child attributes
details.achDebit.correction
code
string
description
string
reason
string
return
object
Show child attributes
details.achDebit.return
code
string
description
string
reason
string
authorization
object
Show child attributes
details.authorization
authorizationID
string
<=36 characters
required
status
string<enum>
required
approved,
declined,
reversed
failureCode
string<enum>
call-issuer,
do-not-honor,
processing-error,
invalid-transaction,
invalid-amount,
no-such-issuer,
reenter-transaction,
cvv-mismatch,
lost-or-stolen,
insufficient-funds,
invalid-card-number,
invalid-merchant,
expired-card,
incorrect-pin,
transaction-not-allowed,
suspected-fraud,
amount-limit-exceeded,
velocity-limit-exceeded,
revocation-of-authorization,
card-not-activated,
issuer-not-available,
could-not-route,
cardholder-account-closed,
account-closed,
account-not-activated,
authentication-failed,
authentication-required,
cardholder-action-required,
format-error,
invalid-pin,
offline-approved,
offline-declined,
partial-approval,
payment-stopped,
pin-required,
record-not-found,
surcharge-not-permitted,
transaction-reversed,
verification-failed,
unknown-issue,
duplicate-transaction
cancellation
object
Show child attributes
details.cancellation
cancellationID
string
<=36 characters
required
status
string<enum>
required
pending,
completed,
failed
capture
object
Show child attributes
details.capture
captureID
string
<=36 characters
required
status
string<enum>
required
created,
pending,
completed,
failed,
canceled
failureCode
string<enum>
call-issuer,
do-not-honor,
processing-error,
invalid-transaction,
invalid-amount,
no-such-issuer,
reenter-transaction,
cvv-mismatch,
lost-or-stolen,
insufficient-funds,
invalid-card-number,
invalid-merchant,
expired-card,
incorrect-pin,
transaction-not-allowed,
suspected-fraud,
amount-limit-exceeded,
velocity-limit-exceeded,
revocation-of-authorization,
card-not-activated,
issuer-not-available,
could-not-route,
cardholder-account-closed,
account-closed,
account-not-activated,
authentication-failed,
authentication-required,
cardholder-action-required,
format-error,
invalid-pin,
offline-approved,
offline-declined,
partial-approval,
payment-stopped,
pin-required,
record-not-found,
surcharge-not-permitted,
transaction-reversed,
verification-failed,
unknown-issue,
duplicate-transaction
cardPayment
object
Show child attributes
details.cardPayment
status
string<enum>
required
initiated,
confirmed,
canceled,
settled,
failed,
completed,
cleared-externally
failureCode
string<enum>
call-issuer,
do-not-honor,
processing-error,
invalid-transaction,
invalid-amount,
no-such-issuer,
reenter-transaction,
cvv-mismatch,
lost-or-stolen,
insufficient-funds,
invalid-card-number,
invalid-merchant,
expired-card,
incorrect-pin,
transaction-not-allowed,
suspected-fraud,
amount-limit-exceeded,
velocity-limit-exceeded,
revocation-of-authorization,
card-not-activated,
issuer-not-available,
could-not-route,
cardholder-account-closed,
account-closed,
account-not-activated,
authentication-failed,
authentication-required,
cardholder-action-required,
format-error,
invalid-pin,
offline-approved,
offline-declined,
partial-approval,
payment-stopped,
pin-required,
record-not-found,
surcharge-not-permitted,
transaction-reversed,
verification-failed,
unknown-issue,
duplicate-transaction
dispute
object
Show child attributes
details.dispute
disputeID
string
<=36 characters
required
phase
string<enum>
required
pre-dispute,
inquiry,
chargeback,
unknown
status
string<enum>
required
The status of a particular dispute.
Read our disputes guide to learn what each status means.
response-needed,
resolved,
under-review,
closed,
accepted,
expired,
won,
lost
captureID
string
<=36 characters
instantBankCredit
object
Show child attributes
details.instantBankCredit
status
string<enum>
required
initiated,
completed,
failed,
accepted-without-posting
failureCode
string<enum>
processing-error,
invalid-account,
account-closed,
account-blocked,
invalid-field,
transaction-not-supported,
limit-exceeded,
invalid-amount,
customer-deceased,
participant-not-available,
other
pullFromCard
object
Show child attributes
details.pullFromCard
status
string<enum>
required
initiated,
failed,
completed
failureCode
string<enum>
call-issuer,
do-not-honor,
processing-error,
invalid-transaction,
invalid-amount,
no-such-issuer,
reenter-transaction,
cvv-mismatch,
lost-or-stolen,
insufficient-funds,
invalid-card-number,
invalid-merchant,
expired-card,
incorrect-pin,
transaction-not-allowed,
suspected-fraud,
amount-limit-exceeded,
velocity-limit-exceeded,
revocation-of-authorization,
card-not-activated,
issuer-not-available,
could-not-route,
cardholder-account-closed,
account-closed,
account-not-activated,
authentication-failed,
authentication-required,
cardholder-action-required,
format-error,
invalid-pin,
offline-approved,
offline-declined,
partial-approval,
payment-stopped,
pin-required,
record-not-found,
surcharge-not-permitted,
transaction-reversed,
verification-failed,
unknown-issue,
duplicate-transaction
pushToCard
object
Show child attributes
details.pushToCard
status
string<enum>
required
initiated,
deferred,
canceled,
failed,
completed
failureCode
string<enum>
call-issuer,
do-not-honor,
processing-error,
invalid-transaction,
invalid-amount,
no-such-issuer,
reenter-transaction,
cvv-mismatch,
lost-or-stolen,
insufficient-funds,
invalid-card-number,
invalid-merchant,
expired-card,
incorrect-pin,
transaction-not-allowed,
suspected-fraud,
amount-limit-exceeded,
velocity-limit-exceeded,
revocation-of-authorization,
card-not-activated,
issuer-not-available,
could-not-route,
cardholder-account-closed,
account-closed,
account-not-activated,
authentication-failed,
authentication-required,
cardholder-action-required,
format-error,
invalid-pin,
offline-approved,
offline-declined,
partial-approval,
payment-stopped,
pin-required,
record-not-found,
surcharge-not-permitted,
transaction-reversed,
verification-failed,
unknown-issue,
duplicate-transaction
refund
object
Show child attributes
details.refund
refundID
string
<=36 characters
required
status
string<enum>
required
created,
pending,
completed,
failed
captureID
string
<=36 characters
failureCode
string<enum>
call-issuer,
do-not-honor,
processing-error,
invalid-transaction,
invalid-amount,
no-such-issuer,
reenter-transaction,
cvv-mismatch,
lost-or-stolen,
insufficient-funds,
invalid-card-number,
invalid-merchant,
expired-card,
incorrect-pin,
transaction-not-allowed,
suspected-fraud,
amount-limit-exceeded,
velocity-limit-exceeded,
revocation-of-authorization,
card-not-activated,
issuer-not-available,
could-not-route,
cardholder-account-closed,
account-closed,
account-not-activated,
authentication-failed,
authentication-required,
cardholder-action-required,
format-error,
invalid-pin,
offline-approved,
offline-declined,
partial-approval,
payment-stopped,
pin-required,
record-not-found,
surcharge-not-permitted,
transaction-reversed,
verification-failed,
unknown-issue,
duplicate-transaction
transfer
object
Show child attributes
details.transfer
status
string<enum>
required
created,
pending,
completed,
failed,
reversed,
queued,
awaiting-capture,
canceled
walletCredit
object
Show child attributes
details.walletCredit
accountID
string
<=36 characters
required
transactionID
string
<=36 characters
required
transactionType
string<enum>
required
account-funding,
ach-reversal,
auto-sweep,
card-payment,
card-decline,
card-reversal,
cash-out,
dispute,
dispute-reversal,
facilitator-fee,
issuing-refund,
issuing-transaction,
issuing-transaction-adjustment,
issuing-auth-hold,
issuing-auth-release,
issuing-decline,
moov-fee,
payment,
payout,
refund,
refund-failure,
rtp-failure,
top-up,
wallet-transfer,
adjustment,
fee-revenue,
residual,
instant-bank-failure
walletID
string
<=36 characters
required
captureID
string
<=36 characters
walletDebit
object
Show child attributes
details.walletDebit
accountID
string
<=36 characters
required
transactionID
string
<=36 characters
required
transactionType
string<enum>
required
account-funding,
ach-reversal,
auto-sweep,
card-payment,
card-decline,
card-reversal,
cash-out,
dispute,
dispute-reversal,
facilitator-fee,
issuing-refund,
issuing-transaction,
issuing-transaction-adjustment,
issuing-auth-hold,
issuing-auth-release,
issuing-decline,
moov-fee,
payment,
payout,
refund,
refund-failure,
rtp-failure,
top-up,
wallet-transfer,
adjustment,
fee-revenue,
residual,
instant-bank-failure
walletID
string
<=36 characters
required
captureID
string
<=36 characters
eventID
string
<=36 characters
eventType
string<enum>
transfer,
authorization,
capture,
refund,
cancellation,
dispute,
ach-credit,
ach-debit,
instant-bank-credit,
card-payment,
push-to-card,
pull-from-card,
wallet-credit,
wallet-debit
occurredOn
string<date-time>