Retrieve counterparties
GET {{url}}/api/1.0/counterparties
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
name | null | The name of the counterparty to retrieve. It does not need to be an exact match, partial match is also supported. | |
account_no | null | The exact account number of the counterparty to retrieve. | |
sort_code | null | The exact sort code of the counterparty to retrieve. Only allowed in combination with the account_no parameter. | |
iban | null | The exact IBAN of the counterparty to retrieve. | |
bic | null | The exact BIC of the counterparty to retrieve. Only allowed in combination with the iban parameter. | |
created_before | string | Used for pagination, retrieves counterparties created before the given date in ISO 8601 format. | |
limit | number | Used 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"}]}]