Retrieve fees for an account
Retrieve fees assessed to an account.
To access this endpoint using an access token
you'll need to specify the /accounts/{accountID}/transfers.read scope.
GET
/accounts/{accountID}/fees
|
|
|
|
|
|
|
|
|
|
|
|
|
|
The request completed successfully.
[
{
"feeID": "9dae7250-d128-4dbb-bc2c-3c2e8a2fb42d",
"accountID": "3dfff852-927d-47e8-822c-2fffc57ff6b9",
"walletID": "0eb7d670-c252-422a-892d-002136c358e0",
"createdOn": "2019-08-24T14:15:22Z",
"feeName": "string",
"amount": {
"currency": "USD",
"valueDecimal": "12.987654321"
},
"generatedBy": {
"transferID": "e23de6dd-5168-4e1d-894d-807fa691dc80",
"cardID": "f159b73e-e9c6-4dce-9609-2274bb1f8396",
"disputeID": "5720fd8c-f7a6-4c10-a19a-d345b5f89bec",
"accountID": "3dfff852-927d-47e8-822c-2fffc57ff6b9",
"bankAccountID": "5b03c365-bcf1-4c70-aeec-29a06f15faf2"
},
"feeGroup": "string",
"residualID": "8df0a983-e21b-44af-a8c4-c35403236f69"
}
]Response headers
x-request-id
string
<uuid>
required
A unique identifier used to trace requests.
The request contained missing or expired authentication.
Response headers
x-request-id
string
<uuid>
required
A unique identifier used to trace requests.
The user is not authorized to make the request.
Response headers
x-request-id
string
<uuid>
required
A unique identifier used to trace requests.
Request was refused due to rate limiting.
Response headers
x-request-id
string
<uuid>
required
A unique identifier used to trace requests.
The request failed due to an unexpected error.
Response headers
x-request-id
string
<uuid>
required
A unique identifier used to trace requests.
The request failed because a downstream service failed to respond.
Response headers
x-request-id
string
<uuid>
required
A unique identifier used to trace requests.
Headers
X-Moov-Version
string
Specify an API version.
API versioning follows the format vYYYY.QQ.BB, where
YYYYis the yearQQis the two-digit month for the first month of the quarter (e.g., 01, 04, 07, 10)BBis the build number, starting at.01, for subsequent builds in the same quarter.- For example,
v2024.01.00is 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.
When no version is specified, the API defaults to v2024.01.00.
Path parameters
accountID
string
<uuid>
required
Query parameters
transferID
string
<uuid>
Optional transfer ID to filter the results by.
disputeID
string
<uuid>
Optional dispute ID to filter the results by.
residualID
string
<uuid>
Optional residual ID to filter the results by.
startDateTime
string
<RFC-3339>
Optional date-time to inclusively filter all fees created after this date-time.
endDateTime
string
<RFC-3339>
Optional date-time to exclusively filter all fees created before this date-time.
skip
integer
<int64>
count
integer
<int64>
Default:
200Response
accountID
string<uuid>
Account ID the fee belongs to.
amount
object
The fee amount.
Show child attributes
currency
string
required
Pattern
A 3-letter ISO 4217 currency code.
valueDecimal
string
required
Pattern
A decimal-formatted numerical string that represents up to 9 decimal place precision.
For example, $12.987654321 is '12.987654321'.
createdOn
string<date-time>
Timestamp when the fee was created.
feeGroup
string
Describes the source of the fee, such as a Moov-set processing fee, a network pass-through fee, or an interchange or discount fee.
feeID
string<uuid>
feeName
string
Name of the fee.
generatedBy
object
Object indicating what generated the fee (TransferID, CardID, DisputeID, AccountID, or BankAccountID).
The entity that generated the fee.
Show child attributes
accountID
string<uuid>
bankAccountID
string<uuid>
cardID
string<uuid>
disputeID
string<uuid>
transferID
string<uuid>
residualID
string<uuid>
Unique identifier for this residual payment calculation.
walletID
string<uuid>
Wallet ID associated with the fee.