For AI agents: markdown of this page — /docs-content-en/entities/bank-details/update.md documentation index — /llms.txt

Update bank detail

PATCH /v1/bank-details/:id

Updates fields of an existing bank detail. Pass only the fields you want to change. Full list — GET /v1/bank-details/fields.

Parameters

Parameter Type Required Description
id (path) number yes Bank detail ID

Request fields (body)

Field Type Required Description
name string no Bank detail name
rqBik string no Bank BIC
rqAccNum string no Current account
rqCorAccNum string no Correspondent account
rqSwift string no SWIFT code
rqIban string no IBAN number
rqBankName string no Bank name
rqBankAddr string no Bank address
rqAccName string no Account holder name
rqAccCurrency string no Account currency
active boolean no Whether the detail is active
sort number no Sort order
comments string no Comment

The id, entityId, countryId, createdAt, updatedAt, createdBy, modifyBy fields are set by the system and ignored on write.

Examples

curl — personal key

Terminal 
curl -X PATCH "https://vibecode.bitrix24.com/v1/bank-details/19" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "rqAccName": "Acme LLC",
    "rqCorAccNum": "30101810400000000225"
  }'

curl — OAuth app

Terminal 
curl -X PATCH "https://vibecode.bitrix24.com/v1/bank-details/19" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "rqAccName": "Acme LLC",
    "rqCorAccNum": "30101810400000000225"
  }'

JavaScript — personal key

javascript 
const res = await fetch('https://vibecode.bitrix24.com/v1/bank-details/19', {
  method: 'PATCH',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    rqAccName: 'Acme LLC',
    rqCorAccNum: '30101810400000000225',
  }),
})

const { success, data } = await res.json()

JavaScript — OAuth app

javascript 
const res = await fetch('https://vibecode.bitrix24.com/v1/bank-details/19', {
  method: 'PATCH',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    rqAccName: 'Acme LLC',
    rqCorAccNum: '30101810400000000225',
  }),
})

const { success, data } = await res.json()

Response fields

Field Type Description
success boolean Always true on success
data object The updated bank detail with current field values
data.id number Record ID
data.entityId number ID of the owner requisite
data.updatedAt datetime New modification date (ISO 8601)
data.modifyBy number ID of the user who performed the update

The object contains all fields in camelCase, including unchanged ones. Unset fields are null. Full list — Bank detail fields.

Response example

JSON 
{
  "success": true,
  "data": {
    "id": 19,
    "entityId": 1,
    "countryId": 0,
    "createdAt": "2026-06-10T10:14:29.000Z",
    "updatedAt": "2026-06-10T10:14:31.000Z",
    "createdBy": 1,
    "modifyBy": 1,
    "name": "Current account",
    "code": null,
    "xmlId": null,
    "originatorId": null,
    "active": true,
    "sort": 500,
    "rqBankName": null,
    "rqBankAddr": null,
    "rqBik": null,
    "rqAccName": "Acme LLC",
    "rqAccNum": "12345678901234567890",
    "rqAccCurrency": null,
    "rqCorAccNum": null,
    "rqIban": "GB29NWBK60161331926819",
    "rqSwift": "NWBKGB2L",
    "comments": null
  }
}

Error response example

404 — bank detail not found:

JSON 
{
  "success": false,
  "error": {
    "code": "ENTITY_NOT_FOUND",
    "message": "The RequisiteBankDetail with ID '999999' is not found"
  }
}

Errors

HTTP Code Description
404 ENTITY_NOT_FOUND No bank detail with this ID found
403 SCOPE_DENIED Key lacks the crm scope. Message: This endpoint requires 'crm' scope
401 TOKEN_MISSING X-Api-Key not provided

Full list of common API errors — Errors.

Known specifics

An empty value clears the field. To clear a field, pass an empty string "". In the response, cleared strings come back as null.

See also