Retrieve a transfer
Retrieve full transfer details for an individual transfer of a particular Moov account.
Payment rail-specific details are included in the source and destination. Read our transfers overview guide to learn more.
To access this endpoint using an access token
you’ll need to specify the /accounts/{accountID}/transfers.read
scope.
|
|
|
|
{
"amount": {
"currency": "USD",
"value": 32945
},
"createdOn": "2025-01-21T21:32:16Z",
"description": "Transfer from card to wallet",
"destination": {
"account": {
"accountID": "34233b72-780c-4a0d-8b08-cbbe23k878f8",
"displayName": "Whole Body Fitness",
"email": "john@wholebodyfitness.io"
},
"paymentMethodID": "3f9969cf-a1f3-4d83-8ddc-229a506651cf",
"paymentMethodType": "moov-wallet",
"wallet": {
"walletID": "744b2e78-8cc8-4a6a-af42-611e3b844503"
}
},
"source": {
"account": {
"accountID": "7e4b26c2-b399-49ef-8390-50e1ea44d550",
"displayName": "Jules Jackson",
"email": "jules@julesjackson.com"
},
"card": {
"billingAddress": {
"postalCode": "80301"
},
"bin": "400020",
"brand": "Visa",
"cardAccountUpdater": {},
"cardID": "aefd5563-93c6-413c-875e-1bd0ebfc116d",
"cardType": "credit",
"cardVerification": {
"accountName": {
"firstName": "unavailable",
"fullName": "unavailable",
"lastName": "unavailable",
"middleName": "unavailable"
},
"addressLine1": "unavailable",
"cvv": "unavailable",
"postalCode": "unavailable"
},
"domesticPullFromCard": "supported",
"domesticPushToCard": "standard",
"expiration": {
"month": "01",
"year": "28"
},
"fingerprint": "2f5d782ceef1c3bd31ed5...",
"holderName": "Jules Jackson",
"issuer": "Moov Visa Sandbox",
"issuerCountry": "US",
"lastFourCardNumber": "2000"
},
"cardDetails": {
"confirmedOn": "2025-01-21T21:32:16.799681237Z",
"dynamicDescriptor": "WhlBdy *Yoga 11-12",
"status": "confirmed"
},
"paymentMethodID": "9506dbf6-4208-44c3-ad8a-e4431660e1f2",
"paymentMethodType": "card-payment"
},
"status": "pending",
"transferID": "d835gf30-4b19-4850-a9b2-c0624c41ecb3"
}
Response headers
x-request-id
string
<uuid>
required
Response headers
x-request-id
string
<uuid>
required
Response headers
x-request-id
string
<uuid>
required
Response headers
x-request-id
string
<uuid>
required
Response headers
x-request-id
string
<uuid>
required
Response headers
x-request-id
string
<uuid>
required
Response headers
x-request-id
string
<uuid>
required
Headers
x-moov-version
string
API version
Specify an API version.
API versioning follows the format vYYYY.QQ.BB
, where
YYYY
is the yearQQ
is the two-digit month for the first month of the quarter (e.g., 01, 04, 07, 10)BB
is the build number, starting at.01
, for subsequent builds in the same quarter.- For example,
v2024.01.00
is the initial release of the first quarter of 2024.
- For example,
The latest
version represents the most recent development state. It may include breaking changes and should be treated as a beta release.
v2024.01.00
Path parameters
transferID
string
<uuid>
required
accountID
string
<uuid>
required
Response
amount
object
required
Show child attributes
currency
string
required
Pattern
value
integer<int64>
required
Quantity in the smallest unit of the specified currency.
In USD this is cents, for example, $12.04 is 1204 and $0.99 is 99.
createdOn
string<date-time>
required
destination
object
required
Show child attributes
account
object
required
Show child attributes
accountID
string
required
displayName
string
required
string
required
paymentMethodID
string
required
paymentMethodType
string<enum>
required
moov-wallet
,
ach-debit-fund
,
ach-debit-collect
,
ach-credit-standard
,
ach-credit-same-day
,
rtp-credit
,
card-payment
,
push-to-card
,
pull-from-card
,
apple-pay
,
card-present-payment
achDetails
object
Show child attributes
status
string<enum>
required
initiated
,
originated
,
corrected
,
returned
,
completed
,
canceled
traceNumber
string
<=15 characters
required
canceledOn
string<date-time>
companyEntryDescription
string
[4 to 10] characters
completedOn
string<date-time>
correctedOn
string<date-time>
correction
object
Show child attributes
code
string
description
string
reason
string
debitHoldPeriod
string<enum>
no-hold
,
1-day
,
2-days
failedOn
string<date-time>
initiatedOn
string<date-time>
originatedOn
string<date-time>
originatingCompanyName
string
[4 to 16] characters
return
object
Show child attributes
code
string
description
string
reason
string
returnedOn
string<date-time>
secCode
string<enum>
WEB
,
PPD
,
CCD
,
TEL
applePay
object
Show child attributes
brand
string<enum>
required
American Express
,
Discover
,
Mastercard
,
Visa
,
Unknown
cardDisplayName
string
required
User-friendly name of the tokenized card returned by Apple.
It usually contains the brand and the last four digits of the underlying card. There is no standard format.
cardType
string<enum>
required
debit
,
credit
,
prepaid
,
unknown
dynamicLastFour
string
required
expiration
object
required
Show child attributes
month
string
2 characters
required
year
string
2 characters
required
fingerprint
string
<=100 characters
required
issuerCountry
string
bankAccount
object
Show child attributes
bankAccountID
string<uuid>
required
bankAccountType
string<enum>
required
checking
,
savings
,
general-ledger
,
loan
bankName
string
required
fingerprint
string
<=100 characters
required
Once the bank account is linked, we don’t reveal the full bank account number.
The fingerprint acts as a way to identify whether two linked bank accounts are the same.
holderName
string
required
holderType
string<enum>
required
individual
,
business
lastFourAccountNumber
string
required
routingNumber
string
required
status
string<enum>
required
new
,
verified
,
verificationFailed
,
pending
,
errored
updatedOn
string<date-time>
required
card
object
Show child attributes
billingAddress
object
required
Show child attributes
postalCode
string
<=10 characters
required
addressLine1
string
<=60 characters
addressLine2
string
<=32 characters
city
string
<=32 characters
country
string
<=2 characters
stateOrProvince
string
<=2 characters
bin
string
[6 to 8] characters
required
brand
string<enum>
required
American Express
,
Discover
,
Mastercard
,
Visa
,
Unknown
cardID
string<uuid>
required
cardType
string<enum>
required
debit
,
credit
,
prepaid
,
unknown
cardVerification
object
required
Show child attributes
accountName
object
required
Show child attributes
firstName
string<enum>
required
noMatch
,
match
,
notChecked
,
unavailable
,
partialMatch
fullName
string<enum>
required
noMatch
,
match
,
notChecked
,
unavailable
,
partialMatch
lastName
string<enum>
required
noMatch
,
match
,
notChecked
,
unavailable
,
partialMatch
middleName
string<enum>
required
noMatch
,
match
,
notChecked
,
unavailable
,
partialMatch
addressLine1
string<enum>
required
noMatch
,
match
,
notChecked
,
unavailable
,
partialMatch
cvv
string<enum>
required
noMatch
,
match
,
notChecked
,
unavailable
,
partialMatch
postalCode
string<enum>
required
noMatch
,
match
,
notChecked
,
unavailable
,
partialMatch
domesticPullFromCard
string<enum>
required
not-supported
,
supported
,
unknown
domesticPushToCard
string<enum>
required
not-supported
,
standard
,
fast-funds
,
unknown
expiration
object
required
Show child attributes
month
string
2 characters
required
year
string
2 characters
required
fingerprint
string
<=100 characters
required
issuer
string
required
issuerCountry
string
required
lastFourCardNumber
string
4 characters
required
cardAccountUpdater
object
Show child attributes
updateType
string<enum>
unspecified
,
account-closed
,
contact-cardholder
,
expiration-update
,
no-change
,
no-match
,
number-update
updatedOn
string<date-time>
cardOnFile
boolean
holderName
string
merchantAccountID
string<uuid>
cardDetails
object
Show child attributes
status
string<enum>
required
initiated
,
confirmed
,
canceled
,
settled
,
failed
,
completed
canceledOn
string<date-time>
completedOn
string<date-time>
confirmedOn
string<date-time>
dynamicDescriptor
string
[4 to 22] characters
failedOn
string<date-time>
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
,
unknown-issue
,
duplicate-transaction
feeProgram
string
initiatedOn
string<date-time>
interchangeQualification
string
deprecated
settledOn
string<date-time>
transactionSource
string<enum>
Specifies the nature and initiator of a transaction.
Crucial for recurring and merchant-initiated transactions as per card scheme rules. Omit for customer-initiated e-commerce transactions.
first-recurring
,
recurring
,
unscheduled
rtpDetails
object
Show child attributes
status
string<enum>
required
initiated
,
completed
,
failed
,
accepted-without-posting
acceptedWithoutPostingOn
string<date-time>
completedOn
string<date-time>
failedOn
string<date-time>
failureCode
string<enum>
processing-error
,
invalid-account
,
account-closed
,
account-blocked
,
invalid-field
,
transaction-not-supported
,
limit-exceeded
,
invalid-amount
,
customer-deceased
,
other
initiatedOn
string<date-time>
networkResponseCode
string
wallet
object
Show child attributes
walletID
string<uuid>
required
source
object
required
Show child attributes
account
object
required
Show child attributes
accountID
string
required
displayName
string
required
string
required
paymentMethodID
string
required
paymentMethodType
string<enum>
required
moov-wallet
,
ach-debit-fund
,
ach-debit-collect
,
ach-credit-standard
,
ach-credit-same-day
,
rtp-credit
,
card-payment
,
push-to-card
,
pull-from-card
,
apple-pay
,
card-present-payment
achDetails
object
Show child attributes
status
string<enum>
required
initiated
,
originated
,
corrected
,
returned
,
completed
,
canceled
traceNumber
string
<=15 characters
required
canceledOn
string<date-time>
companyEntryDescription
string
[4 to 10] characters
completedOn
string<date-time>
correctedOn
string<date-time>
correction
object
Show child attributes
code
string
description
string
reason
string
debitHoldPeriod
string<enum>
no-hold
,
1-day
,
2-days
failedOn
string<date-time>
initiatedOn
string<date-time>
originatedOn
string<date-time>
originatingCompanyName
string
[4 to 16] characters
return
object
Show child attributes
code
string
description
string
reason
string
returnedOn
string<date-time>
secCode
string<enum>
WEB
,
PPD
,
CCD
,
TEL
applePay
object
Show child attributes
brand
string<enum>
required
American Express
,
Discover
,
Mastercard
,
Visa
,
Unknown
cardDisplayName
string
required
User-friendly name of the tokenized card returned by Apple.
It usually contains the brand and the last four digits of the underlying card. There is no standard format.
cardType
string<enum>
required
debit
,
credit
,
prepaid
,
unknown
dynamicLastFour
string
required
expiration
object
required
Show child attributes
month
string
2 characters
required
year
string
2 characters
required
fingerprint
string
<=100 characters
required
issuerCountry
string
bankAccount
object
Show child attributes
bankAccountID
string<uuid>
required
bankAccountType
string<enum>
required
checking
,
savings
,
general-ledger
,
loan
bankName
string
required
fingerprint
string
<=100 characters
required
Once the bank account is linked, we don’t reveal the full bank account number.
The fingerprint acts as a way to identify whether two linked bank accounts are the same.
holderName
string
required
holderType
string<enum>
required
individual
,
business
lastFourAccountNumber
string
required
routingNumber
string
required
status
string<enum>
required
new
,
verified
,
verificationFailed
,
pending
,
errored
updatedOn
string<date-time>
required
card
object
Show child attributes
billingAddress
object
required
Show child attributes
postalCode
string
<=10 characters
required
addressLine1
string
<=60 characters
addressLine2
string
<=32 characters
city
string
<=32 characters
country
string
<=2 characters
stateOrProvince
string
<=2 characters
bin
string
[6 to 8] characters
required
brand
string<enum>
required
American Express
,
Discover
,
Mastercard
,
Visa
,
Unknown
cardID
string<uuid>
required
cardType
string<enum>
required
debit
,
credit
,
prepaid
,
unknown
cardVerification
object
required
Show child attributes
accountName
object
required
Show child attributes
firstName
string<enum>
required
noMatch
,
match
,
notChecked
,
unavailable
,
partialMatch
fullName
string<enum>
required
noMatch
,
match
,
notChecked
,
unavailable
,
partialMatch
lastName
string<enum>
required
noMatch
,
match
,
notChecked
,
unavailable
,
partialMatch
middleName
string<enum>
required
noMatch
,
match
,
notChecked
,
unavailable
,
partialMatch
addressLine1
string<enum>
required
noMatch
,
match
,
notChecked
,
unavailable
,
partialMatch
cvv
string<enum>
required
noMatch
,
match
,
notChecked
,
unavailable
,
partialMatch
postalCode
string<enum>
required
noMatch
,
match
,
notChecked
,
unavailable
,
partialMatch
domesticPullFromCard
string<enum>
required
not-supported
,
supported
,
unknown
domesticPushToCard
string<enum>
required
not-supported
,
standard
,
fast-funds
,
unknown
expiration
object
required
Show child attributes
month
string
2 characters
required
year
string
2 characters
required
fingerprint
string
<=100 characters
required
issuer
string
required
issuerCountry
string
required
lastFourCardNumber
string
4 characters
required
cardAccountUpdater
object
Show child attributes
updateType
string<enum>
unspecified
,
account-closed
,
contact-cardholder
,
expiration-update
,
no-change
,
no-match
,
number-update
updatedOn
string<date-time>
cardOnFile
boolean
holderName
string
merchantAccountID
string<uuid>
cardDetails
object
Show child attributes
status
string<enum>
required
initiated
,
confirmed
,
canceled
,
settled
,
failed
,
completed
canceledOn
string<date-time>
completedOn
string<date-time>
confirmedOn
string<date-time>
dynamicDescriptor
string
[4 to 22] characters
failedOn
string<date-time>
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
,
unknown-issue
,
duplicate-transaction
feeProgram
string
initiatedOn
string<date-time>
interchangeQualification
string
deprecated
settledOn
string<date-time>
transactionSource
string<enum>
Specifies the nature and initiator of a transaction.
Crucial for recurring and merchant-initiated transactions as per card scheme rules. Omit for customer-initiated e-commerce transactions.
first-recurring
,
recurring
,
unscheduled
terminalCard
object
Show child attributes
bin
string
[6 to 8] characters
brand
string<enum>
American Express
,
Discover
,
Mastercard
,
Visa
,
Unknown
cardType
string<enum>
debit
,
credit
,
prepaid
,
unknown
entryMode
string<enum>
contactless
expiration
object
Show child attributes
month
string
2 characters
required
year
string
2 characters
required
fingerprint
string
<=100 characters
holderName
string
issuer
string
issuerCountry
string
lastFourCardNumber
string
4 characters
transferID
string<uuid>
wallet
object
Show child attributes
walletID
string<uuid>
required
status
string<enum>
required
created
,
pending
,
completed
,
failed
,
reversed
,
queued
,
canceled
transferID
string<uuid>
required
cancellations
array
Show child attributes
cancellationID
string
createdOn
string<date-time>
status
string<enum>
pending
,
completed
,
failed
completedOn
string<date-time>
description
string
<=128 characters
disputedAmount
object
Show child attributes
currency
string
required
Pattern
value
integer<int64>
required
Quantity in the smallest unit of the specified currency.
In USD this is cents, for example, $12.04 is 1204 and $0.99 is 99.
disputes
array
Show child attributes
amount
object
Show child attributes
currency
string
required
Pattern
value
integer<int64>
required
Quantity in the smallest unit of the specified currency.
In USD this is cents, for example, $12.04 is 1204 and $0.99 is 99.
createdOn
string<date-time>
disputeID
string<uuid>
facilitatorFee
object
Show child attributes
markup
integer<int64>
markup
or markupDecimal
can be set.
markupDecimal
string
Pattern
markup
, but a decimal-formatted numerical string that represents up to 9 decimal place precision.
Only either markup
or markupDecimal
can be set. Set this field if you expect the fee to be in fractions of a cent.
total
integer<int64>
total
or totalDecimal
can be set.
totalDecimal
string
Pattern
Same as total
, but a decimal-formatted numerical string that represents up to 9 decimal place precision.
Only either total
or totalDecimal
can be set. Set this field if you expect the fee to be in fractions of a cent.
failureReason
string<enum>
source-payment-error
,
destination-payment-error
,
wallet-insufficient-funds
,
rejected-high-risk
,
processing-error
groupID
string
metadata
object
moovFee
integer<int64>
moovFeeDecimal
string
moovFee
, but a decimal-formatted numerical string that represents up to 9 decimal place precision.
moovFeeDetails
object
Show child attributes
moovProcessing
string
required
cardScheme
string
discount
string
interchange
string
occurrenceID
string
refundedAmount
object
Show child attributes
currency
string
required
Pattern
value
integer<int64>
required
Quantity in the smallest unit of the specified currency.
In USD this is cents, for example, $12.04 is 1204 and $0.99 is 99.
refunds
array
Show child attributes
amount
object
Show child attributes
currency
string
required
Pattern
value
integer<int64>
required
Quantity in the smallest unit of the specified currency.
In USD this is cents, for example, $12.04 is 1204 and $0.99 is 99.
cardDetails
object
Show child attributes
status
string<enum>
required
initiated
,
confirmed
,
settled
,
failed
,
completed
completedOn
string<date-time>
confirmedOn
string<date-time>
failedOn
string<date-time>
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
,
unknown-issue
,
duplicate-transaction
initiatedOn
string<date-time>
settledOn
string<date-time>
createdOn
string<date-time>
refundID
string<uuid>
status
string<enum>
created
,
pending
,
completed
,
failed
updatedOn
string<date-time>
scheduleID
string
sweepID
string