MOmollie
Draft Transfers API

Get draft transfer

Changed on

🚧 Beta feature

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

Retrieves a single draft transfer by its identifier.

Only draft transfers created via this API are visible via this endpoint. Draft transfers created in Mollie Apps return a 404, even though they appear in the list endpoint.

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

get/v2/business-accounts/draft-transfers/{draftTransferId}

Request

  • Base URL
    https://api.mollie.com
  • URL
    https://api.mollie.com/v2/business-accounts/draft-transfers/{draftTransferId}
  • Auth
    • HTTP bearer
    • or OAuth 2
      Authorization code: https://my.mollie.com/oauth2/authorize
      Token URL: https://api.mollie.com/oauth2/tokens scopes: business-account-draft-transfers.read

Query parameters

testmodeboolean

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.

Headers

idempotency-keystring
Example:123e4567-e89b-12d3-a456-426

A unique key to ensure idempotent requests. This key should be a UUID v4 string.

Response

The draft transfer object.

resourcestring

Indicates the response contains a draft transfer object. Will always contain the string business-account-draft-transfer for this endpoint.

idstring
mode'live' | 'test'

Whether this entity was created in live mode or in test mode.

debtorIbanstring

The IBAN of the debtor's (sender) Mollie Business Account.

descriptionstring nullable

A short description of the draft transfer. Once approved, this will appear on the bank statement of both the debtor and creditor.

scheduledExecutionDatestring date nullable

The date on which the resulting transfer will be executed, once approved. Defaults to same-day if omitted, in ISO 8601 date format.

status'pending-review' | 'approved' | 'declined'

The status of the draft transfer.

createdAtstring

The entity's date and time of creation, in ISO 8601 format.

approvedAtstring nullable

The date and time the draft transfer was approved, in ISO 8601 format. null unless status is approved.

declinedAtstring nullable

The date and time the draft transfer was declined by the initiator, in ISO 8601 format. null unless statusReason.code is declined-by-initiator.

deletedAtstring nullable

The date and time the draft transfer was deleted via the Cancel draft transfer endpoint, in ISO 8601 format. null unless statusReason.code is deleted-by-creator.

testmodeboolean nullable

Whether to create the entity in test mode or live mode.

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

Example response

{
  "resource": "business-account-draft-transfer",
  "id": "badrt_87GByBuj4UCcUTEbs6aGJ",
  "mode": "live",
  "debtorIban": "NL55MLLE0123456789",
  "debtor": {
    "fullName": "Jan Jansen",
    "account": {
      "iban": "NL02ABNA0123456789"
    }
  },
  "creditor": {
    "fullName": "Jan Jansen",
    "account": {
      "iban": "NL02ABNA0123456789"
    }
  },
  "amount": {
    "currency": "EUR",
    "value": "10.00"
  },
  "description": "Invoice 12345",
  "scheduledExecutionDate": "2025-03-01",
  "status": "pending-review",
  "statusReason": {
    "code": "deleted-by-creator",
    "message": "The draft transfer has been deleted by the user who created it"
  },
  "createdAt": "2024-03-20T09:13:37+00:00",
  "approvedAt": "2025-01-01T12:05:00+00:00",
  "declinedAt": "2025-01-01T12:05:00+00:00",
  "deletedAt": "2025-01-01T12:05:00+00:00",
  "_links": {
    "self": {
      "href": "https://api.mollie.com/v2/business-accounts/draft-transfers/badrt_87GByBuj4UCcUTEbs6aGJ",
      "type": "application/hal+json"
    }
  }
}

Changes