List counterparty bank accounts
Returns standalone counterparty bank accounts visible to the requesting user in the standard Corebanq getAll response shape.
Authorization
bearerAuth In: header
Query Parameters
Maximum number of rows to return. Defaults to 10 and is capped at 100 by the shared query parser.
Number of rows to skip before collecting the result set.
Sorting instructions using the shared getAll format, for example -created_at or name,-modified_at.
Optional JSON object with structured filters.
Filter bank accounts by ID.
Filter bank accounts by counterparty ID.
Filter bank accounts by IBAN.
Filter bank accounts by BIC.
Filter bank accounts by bank name.
Filter bank accounts by primary flag.
Filter bank accounts by validated flag.
Case-insensitive text search over searchable bank account fields.
Group results by this field; data becomes an object keyed by the field's values and keys lists the group keys.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/counterparties/bank-accounts"{
"data": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"recipient_id": "b6731cb5-d462-49ea-afb8-7933b670b560",
"cp_account_id": "eb064395-4075-439f-a7b1-d660c0883425",
"iban": "string",
"bic": "string",
"bank": "string",
"intermediate_bic": "string",
"intermediate_bank": "string",
"intermediate_route": "string",
"is_primary": true,
"is_validated": true,
"active": true,
"created_at": "2019-08-24T14:15:22Z",
"created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
"modified_at": "2019-08-24T14:15:22Z",
"modified_by": "e8d4374d-93a1-4e98-a6c6-fdcf00c5059f",
"metadata": {},
"products_allowed": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"code": "string",
"name": "string",
"description": "string",
"type": "string",
"route": "string",
"icon": "string"
}
],
"counterparty_id": "fd38dae9-b300-4017-a630-101c4279eafd"
}
],
"total": 0,
"total_unfiltered": 0,
"has_more": true,
"metadata": {},
"keys": [
"string"
]
}{
"status": 400,
"message": "Invalid input"
}{
"status": 401,
"message": "Unauthorized"
}{
"status": 403,
"message": "Forbidden"
}{
"status": 500,
"message": "server_error"
}Handler: CreateCounterparty → CreateCounterpartySrv. Creates a new owner-scoped counterparty. Inline contacts and addresses may be created or reassigned by ID, and bank accounts / crypto wallets may be linked by ID or created inline through a recipient-backed flow. Non-empty own_accounts payloads are rejected with 400.
Returns one bank account (in the recipients.bank_accounts table, exposed under the counterparties bank-accounts API) if the caller has record read access. An inactive bank account (active=false) is hidden from callers without the Internal RBAC role — the endpoint returns 404 Not Found as if the record did not exist. Callers holding the Internal role can retrieve inactive bank accounts.