Get a wire transfer

GET /v2/wire_transfers/{id}

Path parameters

  • id string(uuid) Required

    ID of the wire transfer.

Responses

  • 200 application/json

    OK

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

      ID of the wire transfer

    • reference string(uuid) Required

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

    • instructed_amount integer(int64) Required

      Amount of the wire transfer, in the smallest unit of the instructed currency.

    • instructed_currency string Required

      Currency of the wire transfer, in ISO 4217 format.

    • account_id string(uuid)

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

    • local_iban string Required

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

    • beneficiary_account_identifier object Required

      Account identifier of the beneficiary.

      One of:
    • message string Required

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

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

    • uetr string

      Unique End-to-end Transaction Reference for this wire transfer. This allows you to track and trace the transaction through tools like Swift GPI.

    • Custom identifier attached to the transaction resulting from this wire 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 attached to the transaction resulting from this wire transfer. It is not transmitted nor visible in your Memo Bank workspace and can only be retrieved via API.

    • status string Required

      Current status of the wire transfer.

      Values are pending, pending_attachment_required, authorized, confirmed, returned, or failed.

    • Code that represents the failure reason when the wire transfer has failed.

      Values are insufficient_funds, execution_failure, 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, new_beneficiary_is_owned_iban, iban_and_bic_inconsistency, country_and_account_identifier_inconsistency, country_unavailable, currency_unavailable, amount_too_low, amount_too_high, invalid_account_identifier_for_country, invalid_routing_code_for_country, missing_beneficiary_lei, beneficiary_bank_account_closed, beneficiary_bank_error, beneficiary_bank_invalid_bank_details, beneficiary_bank_refusal, intermediary_system_error, memo_error, or memo_refusal.

GET /v2/wire_transfers/{id}
curl \
 --request GET 'https://api.memo.bank/v2/wire_transfers/aa431134-bdc4-416e-8b7e-58a39e389707' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200)
{
  "id": "61b05c4f-3f72-4951-8c30-a2a9faaa5184",
  "reference": "ab004cfc-99fb-4ba9-bc9c-70982f853cb1",
  "instructed_amount": 500,
  "instructed_currency": "EUR",
  "account_id": "708683cb-60f6-464a-a62f-be2e339c34aa",
  "local_iban": "FR6430003000509825397888D64",
  "beneficiary_account_identifier": {
    "type": "iban_and_bic",
    "iban": "FR2512739000308553756377J95",
    "bic": "MEMOFRP2XXX"
  },
  "message": "invoice no12345",
  "internal_note": "phone bill",
  "uetr": "62dacdad-b003-4738-b21d-29fbfca5d1ea",
  "custom_id": "637406efda8534de8c0e",
  "custom_metadata": "This is some metadata",
  "status": "failed",
  "failure_code": "insufficient_funds"
}