Get the status of individual transfers in a bulk

GET /v2/transfers/bulks/{id}/transfers

Path parameters

  • id string(uuid) Required

    ID of the bulk.

Query parameters

  • status array[string]

    Filter transfers by status.

    Values are pending, scheduled, authorized, confirmed, canceled, or failed.

  • page integer(int32)

    Index of the requested page.

    Minimum value is 1. Default value is 1.

  • size integer(int32)

    Number of elements per page in response.

    Minimum value is 1, maximum value is 100. Default value is 10.

Responses

  • • 200 application/json

    OK

    Hide response attributes Show response attributes object
    • results array[object] Required

      Elements of the page.

      Hide results attributes Show results attributes object
      • id string(uuid) Required

        ID of the transfer

      • reference string(uuid) Required

        Unique reference, can be used to correlate with the resulting Transaction.

      • amount integer(int64) Required

        Amount of the transfer, in cents.

      • currency string Required

        Currency of the amount, in ISO 4217 format.

      • local_iban string Required

        IBAN used as a source of the transfer. It can be the main IBAN of an account or a virtual IBAN.

      • account_id string(uuid)

        ID of the account this transfer belongs to, it can be missing while we process it according to the local IBAN.

      • beneficiary_iban string Required

        IBAN of the beneficiary.

      • transfer_type string

        Type of the transfer. If the type strategy is instant_if_available, it can be missing while we determine the appropriate type.

        Values are standard or instant.

      • type_strategy string Required

        Strategy used when creating the transfer.

        Values are standard_only, instant_only, or instant_if_available.

      • status string Required

        Current status of the transfer.

        Values are pending, scheduled, authorized, confirmed, canceled, or failed.

      • failure_code string

        Code that represents the failure reason when the transfer has failed:

        • insufficient_funds: Not enough funds on your account to execute the transfer.
        • execution_failure: The transfer was executed but failed before settlement.
        • instant_transfer_not_available: The beneficiary can not receive instant transfers.
        • invalid_beneficiary_iban: The beneficiary's IBAN is invalid.
        • unreachable_beneficiary_iban: The beneficiary is unreachable for the given transfer type.
        • maximum_amount_exceeded: The transfer amount exceeds the limit.

        The following codes are only returned if the transfer was executed as part of a bulk:

        • current_account_not_found: The provided local IBAN does not exist.
        • transfer_to_same_account: The transfer cannot credit the debtor account.
        • transfer_to_owned_account_with_virtual_iban: A virtual IBAN cannot be used to transfer between your accounts.
        • transfer_from_saving_account_to_external_beneficiary: You cannot transfer money to external beneficiaries from the Booster account.
        • missing_new_beneficiary_name: The beneficiary does not exist and the name was not provided.
        • new_beneficiary_is_owned_iban: The beneficiary does not exist and is one of your IBAN.

        Values are insufficient_funds, execution_failure, instant_transfer_not_available, invalid_beneficiary_iban, unreachable_beneficiary_iban, maximum_amount_exceeded, current_account_not_found, transfer_to_same_account, transfer_to_owned_account_with_virtual_iban, transfer_from_saving_account_to_external_beneficiary, missing_new_beneficiary_name, or new_beneficiary_is_owned_iban.

      • scheduled_date string(date)

        Date on which the transfer was scheduled, if any.

      • message string

        Message attached to this transfer, visible to all involved parties.

      • end_to_end_id string

        Unique identification to unambiguously identify the transaction. This identification is passed on, unchanged, throughout the entire end-to-end chain. It can be used for reconciliation or to link tasks relating to the transaction.

      • internal_note string

        Internal note attached to this transfer, visible only in your Memo Bank workspace.

      • custom_id string

        Custom identifier attached to the transaction resulting from this transfer. It is not transmitted nor visible in your Memo Bank workspace. It can only be retrieved or used to search for transactions via Memo Bank API.

      • custom_metadata string

        Custom metadata attached to the transaction resulting from this transfer. It is not transmitted nor visible in your Memo Bank workspace and can only be retrieved via API.

    • has_prev boolean Required

      Flag indicating if there is a previous page.

    • has_next boolean Required

      Flag indicating if there is a next page.
GET /v2/transfers/bulks/{id}/transfers 
curl \
 -X GET https://api.memo.bank/v2/transfers/bulks/6ba07619-24ff-43f3-b1f0-cdc9b06bf8a7/transfers \
 -H "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200) 
{
  "results": [
    {
      "id": "61b05c4f-3f72-4951-8c30-a2a9faaa5184",
      "reference": "ab004cfc-99fb-4ba9-bc9c-70982f853cb1",
      "amount": 500,
      "currency": "EUR",
      "local_iban": "FR6430003000509825397888D64",
      "account_id": "708683cb-60f6-464a-a62f-be2e339c34aa",
      "beneficiary_iban": "FR2512739000308553756377J95",
      "transfer_type": "standard",
      "type_strategy": "standard_only",
      "status": "failed",
      "failure_code": "insufficient_funds",
      "scheduled_date": "2024-05-04",
      "message": "invoice no12345",
      "end_to_end_id": "b0bfb42baa2642c2af0ca3e880fcd590",
      "internal_note": "phone bill",
      "custom_id": "637406efda8534de8c0e",
      "custom_metadata": "This is some metadata"
    }
  ],
  "has_prev": true,
  "has_next": true
}