List draft transfers

get

https://api.mollie.com/v2/business-accounts/draft-transfers

🚧
Beta feature
This feature is currently in beta testing, and the final specification may still change.

Retrieves a list of draft transfers created via this API for the organization.

The results are paginated.

In test mode, this returns synthetic draft transfers only, not your real data. See Create draft transfer for how to simulate approved and declined outcomes.

🔑
Access with
Advanced access token with business-account-draft-transfers.readOAuth access with business-account-draft-transfers.read

Query Params

from

string

Provide an ID to start the result set from the item with the given ID and onwards. This allows you to paginate the result set.

limit

integer | null

1 to 250

Defaults to 50

The maximum number of items to return. Defaults to 50 items.

status

string

Filter the list by draft transfer status. Omit to return draft transfers in any status.

Possible values: pending-review approved declined

Show Details

pending-review	Waiting for a human initiator to approve or decline it in Mollie Apps.
approved	Approved by the initiator.
declined	Declined, either by the initiator, the creator, or because the debtor account was closed.

testmode

boolean

Most API credentials are specifically created for either live mode or test mode. In those cases the testmode query parameter must not be sent. For organization-level credentials such as OAuth access tokens, you can enable test mode by setting the testmode query parameter to true.

Test entities cannot be retrieved when the endpoint is set to live mode, and vice versa.

Responses

Language

Credentials

Loading…

Response

Choose an example:

application/hal+json

200A list of draft transfer objects.

400The request contains issues. For example, if the specified from value is not a valid ID.

429Rate Limit has been reached.