/v2/ibans/subaccounts/{id}

GET

Get a list of IBANs attached to a sub-account.

The API responses shown below are static. If you want to try out the API please login, or register for an API key

API parameters

Required
NameInTypeDescriptionEnumDefault
X-Auth-Token header string Authentication token.
id path string Sub-account UUID.
Optional
NameInTypeDescriptionEnumDefault
page query integer Page number.
per_page query integer Number of results per page.
order query string Any field name to change the sort order.
order_asc_desc query string Sort records in ascending or descending order. asc
desc
asc
curl -X GET  --header "X-Auth-Token: XXXX-XXXXX-XXXX"  https://devapi.currencycloud.com/v2/ibans/subaccounts/{id}

Response

{
    "ibans": [
        {
            "id": "7e56a996-d191-4d3f-80a8-ee0d313f2f71",
            "account_id": "22ed17b5-b90c-424e-aa78-d24928b1778e",
            "iban_code": "GB49TCCL00997930436882",
            "currency": "EUR",
            "account_holder_name": "Test Sub Account",
            "bank_institution_name": "The Currency Cloud",
            "bank_institution_address": "12 Steward Street, The Steward Building, London, E1 6FQ, GB",
            "bank_institution_country": "United Kingdom",
            "bic_swift": "TCCLGB31",
            "created_at": "2018-04-26T15:42:01+00:00",
            "updated_at": "2018-04-26T15:42:01+00:00"
        }
    ],
    "pagination": {
        "total_entries": 1,
        "total_pages": 1,
        "current_page": 1,
        "per_page": 25,
        "previous_page": -1,
        "next_page": -1,
        "order": "created_at",
        "order_asc_desc": "asc"
    }
}
Error Codes
HTTP Status Code Description Params
400 ibans_not_found IBANs were not found
account_not_found Account was not found for this id
401 invalid_supplied_credentials Authentication failed with the supplied credentials
429 too_many_requests Too many requests have been made to the api. Please refer to the Developer Center for more information
500 internal_server_error Internal server error
503 service_unavailable Service is temporary unavailable
Was this page helpful?
Yes
No