Retrieve counterparties

GET {{url}}/api/1.0/counterparties

Request Params

KeyDatatypeRequiredDescription
namenullThe name of the counterparty to retrieve. It does not need to be an exact match, partial match is also supported.
account_nonullThe exact account number of the counterparty to retrieve.
sort_codenullThe exact sort code of the counterparty to retrieve. Only allowed in combination with the account_no parameter.
ibannullThe exact IBAN of the counterparty to retrieve.
bicnullThe exact BIC of the counterparty to retrieve. Only allowed in combination with the iban parameter.
created_beforestringUsed for pagination, retrieves counterparties created before the given date in ISO 8601 format.
limitnumberUsed for pagination, sets the number of results to return per page.

RESPONSES

status: OK

[{"id":"239d6f1f-2222-4ae6-1111-5cc603341b4e","name":"Jane Doe Co.","state":"created","created_at":"2022-09-14T14:47:12.273718Z","updated_at":"2022-09-14T14:47:12.273718Z","accounts":[{"iban":"GB66REVO00996995908786","bic":"REVOGB21","id":"b209281b-aakk-9911-8d83-ac72469cef8f","type":"external","name":"Jane Doe Co.","bank_country":"GB","currency":"EUR","recipient_charges":"no"}]},{"id":"8e0e9886-0af1-4b0c-acf4-111180d2892b","name":"John Smith","revtag":"johnsmith","profile_type":"personal","country":"GB","state":"created","created_at":"2022-09-14T14:41:39.312017Z","updated_at":"2022-09-14T14:41:39.312017Z"},{"id":"e7e36cce-2e9c-4e96-818e-1c2fed325852","name":"John Doe Co.","state":"created","created_at":"2022-08-14T14:34:11.168340Z","updated_at":"2022-08-14T14:34:11.168340Z","accounts":[{"account_no":"12345674","sort_code":"540107","id":"e277b2bd-3a6d-423b-933d-3d425094bb13","type":"external","name":"John Doe Co.","bank_country":"GB","currency":"GBP","recipient_charges":"no"}]},{"id":"239d6f1f-2222-4ae6-1111-5cc603341b4e","name":"John Smith Co.","state":"created","created_at":"2022-09-14T14:47:12.273718Z","updated_at":"2022-09-14T14:47:12.273718Z","accounts":[{"iban":"FR1420041010050500013M02606","bic":"PSSTFRPPLIL","id":"b209281b-aakk-9911-8d83-ac72469cef8f","type":"external","name":"John Smith Co.","bank_country":"FR","currency":"EUR","recipient_charges":"no"}]},{"id":"173e6a6b-d955-465f-8f31-7f6f7c03927c","name":"Johann Meier Co.","state":"created","created_at":"2023-08-10T12:43:20.273500Z","updated_at":"2023-08-10T12:43:20.273500Z","accounts":[{"iban":"CH5604835012345678009","bic":"UBSWCHZH80A","id":"b3cc43e8-f141-459b-9bd5-3505cf9797f8","type":"external","name":"Johann Meier Co.","bank_country":"CH","currency":"EUR","recipient_charges":"no"}]}]