---
title: "listTransferSchedules"
method: GET
path: "/finances/transfers/wallet/2024-03-01/transferSchedules"
tags: ["Seller Wallet v2024-03-01"]
---

# listTransferSchedules

`GET /finances/transfers/wallet/2024-03-01/transferSchedules`

Retrieve transfer schedules of a Seller Wallet bank account.

## Query parameters

- `accountId` string, required
- `marketplaceId` string, required
- `nextPageToken` string

## Response `200`

Success

- TransferScheduleListing — A list of transfer schedules.
  - `nextPageToken` string — A token that you use to retrieve the next page of results. The response includes `nextPageToken` when the number of results exceeds 100. To get the next page of results, call the operation with this token and include the same arguments as the call that produced the token. To get a complete list, call this operation until `nextPageToken` is null. Note that this operation can return empty pages.
  - `transferSchedules` TransferSchedule[], required — A list of transfer schedules.
    - `transferScheduleId` string, required — The unique identifier provided by Amazon to the scheduled transfer.
    - `transactionType` 'CREDIT' | 'DEBIT', required — The type of transaction.
    - `transactionSourceAccount` TransactionAccount — Details of the bank account involved in the transaction.
      - `accountId` string — The unique identifier provided by Amazon to identify the account.
      - `bankAccountHolderName` string — The account holder's name.
      - `bankName` string, required — The name of the bank.
      - `bankAccountNumberFormat` 'IBAN' | 'BBAN', required — The format of the bank account number.
      - `bankAccountNumberTail` string — The last three digits of the bank account number.
      - `bankAccountCountryCode` string — The two-digit country code, in ISO 3166 format. This field is optional for `transactionSourceAccount`, but is mandatory for `transactionDestinationAccount`.
      - `bankAccountCurrency` string, required — The currency code in ISO 4217 format.
    - `transactionDestinationAccount` TransactionAccount, required — Details of the bank account involved in the transaction.
      - `accountId` string — The unique identifier provided by Amazon to identify the account.
      - `bankAccountHolderName` string — The account holder's name.
      - `bankName` string, required — The name of the bank.
      - `bankAccountNumberFormat` 'IBAN' | 'BBAN', required — The format of the bank account number.
      - `bankAccountNumberTail` string — The last three digits of the bank account number.
      - `bankAccountCountryCode` string — The two-digit country code, in ISO 3166 format. This field is optional for `transactionSourceAccount`, but is mandatory for `transactionDestinationAccount`.
      - `bankAccountCurrency` string, required — The currency code in ISO 4217 format.
    - `transferScheduleStatus` 'ENABLED' | 'DISABLED' | 'EXPIRED' | 'DELETED', required — The schedule status of the transfer.
    - `transferScheduleInformation` TransferScheduleInformation, required — Mandatory information for initiating a schedule transfer.
      - `scheduleStartDate` string, date-time — The start date of the scheduled transfer.
      - `scheduleEndDate` string, date-time — The end date of the scheduled transfer.
      - `scheduleExpression` ScheduleExpression — The configuration of the schedule.
        - `scheduleExpressionType` 'RECURRING' | 'ONE_TIME', required — The type of scheduled transfer expression.
        - `recurringFrequency` 'DAILY' | 'WEEKLY' | 'BIWEEKLY' | 'MONTHLY' — The frequency at which the transaction is repeated.
      - `scheduleType` 'TIME_BASED' — The type of schedule the transfer is on. Schedules based on time patterns use EventBridge.
    - `paymentPreference` PaymentPreference — The type of payment preference in which the transfer is being scheduled.
      - `paymentPreferencePaymentType` 'PERCENTAGE' | 'AMOUNT', required — The type of payment preference.
      - `value` number, required — A decimal number, such as an amount or FX rate.
    - `transferScheduleFailures` TransferScheduleFailures[], required — A list of transfer schedule failures.
      - `transferScheduleFailureDate` string, date-time, required — The transfer schedule failure date.
      - `transferScheduleFailureReason` string, required — The reason listed for the failure of the transfer schedule.

## Other responses

- `400` — Request has missing or invalid parameters and cannot be parsed.
- `403` — Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
- `404` — The resource specified does not exist.
- `408` — Request Timed Out.
- `413` — The request size exceeded the maximum accepted size.
- `415` — The request payload is in an unsupported format.
- `429` — The frequency of requests was greater than allowed.
- `500` — An unexpected condition occurred that prevented the server from fulfilling the request.
- `503` — Temporary overloading or maintenance of the server.

---

[API](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01.md) · [All operations](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws-samples/a-content-management-v2020-11-01/revisions/815a5b6dbaa6/schema)