GET /v1/ibans
Jwt

Query parameters

  • account_id string(uuid)

    ID of the account.

  • include_deleted boolean

    When set to true, results will include IBANs that have been deleted.

    Default value is false.

  • 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 IBAN.

      • account_id string(uuid) Required

        ID of the account this IBAN belongs to.

      • iban string Required

        Actual value of the IBAN.

      • name string Required

        Name of the IBAN.

      • status string Required

        Status of the IBAN. It determines if an IBAN accepts incoming or outgoing transfers.

        Values are active or inactive.

      • type string Required

        Flag indicating if this IBAN is the main IBAN of an account, or a virtual IBAN. Please note that main IBANs cannot be updated or deleted.

        Values are main or virtual.

      • allow_collections boolean Required

        Whether or not this IBAN accepts incoming collections.

      • is_deleted boolean Required

        Whether or not this IBAN has been deleted.

    • 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 /v1/ibans 
curl \
 --request GET 'https://api.memo.bank/v1/ibans' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200) 
{
  "results": [
    {
      "id": "c70bd7bc-58e0-4fdb-8c1f-70186e0de587",
      "account_id": "29883c3d-0b11-4c38-91b0-af9018cc5b14",
      "iban": "FR27590171083068762111832788",
      "name": "customer no12345",
      "status": "active",
      "type": "virtual",
      "allow_collections": true,
      "is_deleted": false
    }
  ],
  "has_prev": true,
  "has_next": true
}