Returns a list of the bank accounts table entries for a given employee.
Important:
The Bank Account details are listed under the 'Financial' category in Bob's UI. They include basic bank account details, and may include also a list of bank accounts (if using more than a single bank account).
If you are using a list of Bank Accounts:
Use this endpoint will fetch the list of bank accounts.
Use the Read metadata for specific custom table endpoint and provide the table name: `bankAccounts` to fetch the table's metadata.
If you are using only a single Bank Account:
To fetch the basic bank account details (not the table), use the employee's search endpoint instead, and specify the fields you want to fetch (e.g. 'financial.bankName'). To learn more, see how to work with Fields, Custom fields and Lists.
See the '200' response for the body response.
# OpenAPI definition
```json
{
"openapi": "3.1.1",
"info": {
"title": "Employee data API",
"description": "Access your employees data with the Public API",
"license": {
"name": "Proprietary",
"url": "https://apidocs.hibob.com/docs/api-terms-of-use"
},
"contact": {
"name": "Hi Bob, Inc."
},
"version": "1.0.0"
},
"servers": [
{
"url": "https://api.hibob.com/v1",
"description": "Production"
},
{
"url": "https://api.sandbox.hibob.com/v1",
"description": "Sandbox"
}
],
"x-readme": {
"metrics-enabled": false
},
"tags": [
{
"name": "Employee Tables",
"description": "Operations for employee tables (work, employment, lifecycle, salaries, equities, variable, training, bank accounts)"
},
{
"name": "Employee data Webhooks",
"description": "Webhook events for employee and table entry operations"
}
],
"webhooks": {
"employeeCreated": {
"post": {
"operationId": "post_webhook_employee-created",
"tags": [
"Employee data Webhooks"
],
"summary": "Employee created",
"description": "Triggered when an employee is created.\n\nIn the right panel, open **Examples** and select **Payload Example** to see a real payload.\n",
"parameters": [
{
"name": "bob-signature",
"in": "header",
"required": true,
"description": "Base64-encoded signature sent with each webhook request. Use it to verify that the request came from Bob. To verify webhook authenticity, see How does Bob calculate the signature.",
"schema": {
"type": "string",
"example": "EQScIBkAtTKFW0ictgt5zzOsqIc2+xGEsM88jOdLuW4CM/a3gLEfrKV+IC5IHx0xbirzLKPIfaZjCGwzuiyI8w=="
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EmployeeCreatedEvent"
},
"example": {
"companyId": 637323,
"type": "employee.created",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2024-12-26T11:29:14.399997",
"version": "v2",
"data": {
"employeeId": "3332883894235038486"
}
}
}
}
},
"responses": {
"200": {
"description": "Webhook received successfully"
},
"400": {
"description": "Invalid webhook payload",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
}
},
"security": []
}
},
"employeeUpdated": {
"post": {
"operationId": "post_webhook_employee-updated",
"tags": [
"Employee data Webhooks"
],
"summary": "Employee updated",
"description": "Triggered when an employee's field is updated.\n\nThe payload includes only the fields that were explicitly changed. Calculated\nfields affected by an update (e.g., age when birthDate changes) are not included.\n\nThis event is also sent when a table entry create or update causes employee-level fields to change; the payload then contains the affected field IDs in fieldUpdates. Bank accounts and custom tables do not trigger this event when their entries change.\n\nIn the right panel, open **Examples** and select **Payload Example** to see a real payload.\n",
"parameters": [
{
"name": "bob-signature",
"in": "header",
"required": true,
"description": "Base64-encoded signature sent with each webhook request. Use it to verify that the request came from Bob. To verify webhook authenticity, see How does Bob calculate the signature.",
"schema": {
"type": "string",
"example": "EQScIBkAtTKFW0ictgt5zzOsqIc2+xGEsM88jOdLuW4CM/a3gLEfrKV+IC5IHx0xbirzLKPIfaZjCGwzuiyI8w=="
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EmployeeUpdatedEvent"
},
"examples": {
"profileField": {
"summary": "Profile field change",
"value": {
"companyId": 637323,
"type": "employee.updated",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2024-12-26T11:29:14.399997",
"version": "v2",
"data": {
"employeeId": "3332883894235038486",
"fieldUpdates": [
{
"id": "personal.birthDate"
}
]
}
}
},
"afterLifecycleTable": {
"summary": "After lifecycle table change",
"value": {
"companyId": 636192,
"type": "employee.updated",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2025-01-08T13:06:26.893941",
"version": "v2",
"data": {
"employeeId": "3332883854254932743",
"fieldUpdates": [
{
"id": "employee.recentLeaveStartDate"
},
{
"id": "internal.status"
},
{
"id": "employee.recentLeaveEndDate"
},
{
"id": "internal.lifecycleStatus"
}
]
}
}
},
"afterWorkTable": {
"summary": "After work table change",
"value": {
"companyId": 636192,
"type": "employee.updated",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2025-01-08T13:28:55.545382",
"version": "v2",
"data": {
"employeeId": "3332883904477528858",
"fieldUpdates": [
{
"id": "work.department"
},
{
"id": "work.title"
},
{
"id": "work.activeEffectiveDate"
}
]
}
}
},
"afterEmploymentTable": {
"summary": "After employment table change",
"value": {
"companyId": 636192,
"type": "employee.updated",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2025-01-08T13:51:59.905057",
"version": "v2",
"data": {
"employeeId": "3332883904477528858",
"fieldUpdates": [
{
"id": "payroll.employment.type"
}
]
}
}
},
"afterSalaryTable": {
"summary": "After salary table change",
"value": {
"companyId": 636192,
"type": "employee.updated",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2026-03-02T12:17:21.974884",
"version": "v2",
"data": {
"employeeId": "3460447757808959739",
"fieldUpdates": [
{
"id": "payroll.salary.activeEffectiveDate"
},
{
"id": "payroll.salary.payPeriod"
},
{
"id": "payroll.salary.monthlyPayment"
},
{
"id": "payroll.salary.yearlyPayment"
},
{
"id": "payroll.salary.payment"
},
{
"id": "payroll.salary.payFrequency"
}
]
}
}
},
"afterAddressTable": {
"summary": "After address table change",
"value": {
"companyId": 636192,
"type": "employee.updated",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2026-03-02T12:19:35.027449",
"version": "v2",
"data": {
"employeeId": "3460447757808959739",
"fieldUpdates": [
{
"id": "address.postCode"
},
{
"id": "address.country"
}
]
}
}
},
"afterVariablePayTable": {
"summary": "After variable pay table change",
"value": {
"companyId": 636192,
"type": "employee.updated",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2026-03-02T12:16:38.725127",
"version": "v2",
"data": {
"employeeId": "3460447757808959739",
"fieldUpdates": [
{
"id": "payroll.variable.Executive bonus.amount"
},
{
"id": "payroll.variable.Bonus.paymentPeriod"
},
{
"id": "payroll.variable.Bonus.amount"
},
{
"id": "payroll.variable.Bonus.payoutType"
},
{
"id": "payroll.variable.Executive bonus.payoutType"
},
{
"id": "payroll.variable.Executive bonus.paymentPeriod"
}
]
}
}
},
"afterEntitlementTable": {
"summary": "After entitlement table change",
"value": {
"companyId": 636192,
"type": "employee.updated",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2026-03-02T12:15:08.446777",
"version": "v2",
"data": {
"employeeId": "3460447757808959739",
"fieldUpdates": [
{
"id": "payroll.entitlement.Season ticket loans.amount"
},
{
"id": "payroll.entitlement.Childcare vouchers.amount"
}
]
}
}
}
}
}
}
},
"responses": {
"200": {
"description": "Webhook received successfully"
},
"400": {
"description": "Invalid webhook payload",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
}
},
"security": []
}
},
"employeeDeleted": {
"post": {
"operationId": "post_webhook_employee-deleted",
"tags": [
"Employee data Webhooks"
],
"summary": "Employee deleted",
"description": "Triggered when an employee is deleted.\n\nThe payload includes the employee email so you can retain a reference to the\ndeleted employee after their record is no longer accessible.\n\nIn the right panel, open **Examples** and select **Payload Example** to see a real payload.\n",
"parameters": [
{
"name": "bob-signature",
"in": "header",
"required": true,
"description": "Base64-encoded signature sent with each webhook request. Use it to verify that the request came from Bob. To verify webhook authenticity, see How does Bob calculate the signature.",
"schema": {
"type": "string",
"example": "EQScIBkAtTKFW0ictgt5zzOsqIc2+xGEsM88jOdLuW4CM/a3gLEfrKV+IC5IHx0xbirzLKPIfaZjCGwzuiyI8w=="
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EmployeeDeletedEvent"
},
"example": {
"companyId": 639814,
"type": "employee.deleted",
"triggeredBy": "3647561042940134248",
"triggeredAt": "2025-08-11T08:02:39.118536",
"version": "v2",
"data": {
"employeeId": "3647561274138559361",
"email": "zoe.clark_639814@samplebob.com"
}
}
}
}
},
"responses": {
"200": {
"description": "Webhook received successfully"
},
"400": {
"description": "Invalid webhook payload",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
}
},
"security": []
}
},
"employeeJoined": {
"post": {
"operationId": "post_webhook_employee-joined",
"tags": [
"Employee data Webhooks"
],
"summary": "Employee joined",
"description": "Triggered when an employee is granted access, once the corresponding\nlifecycle entry becomes effective.\n\nLifecycle events are triggered automatically at midnight on the effective\ndate of the lifecycle table entry (according to the site's timezone).\n\nIn the right panel, open **Examples** and select **Payload Example** to see a real payload.\n",
"parameters": [
{
"name": "bob-signature",
"in": "header",
"required": true,
"description": "Base64-encoded signature sent with each webhook request. Use it to verify that the request came from Bob. To verify webhook authenticity, see How does Bob calculate the signature.",
"schema": {
"type": "string",
"example": "EQScIBkAtTKFW0ictgt5zzOsqIc2+xGEsM88jOdLuW4CM/a3gLEfrKV+IC5IHx0xbirzLKPIfaZjCGwzuiyI8w=="
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EmployeeJoinedEvent"
},
"example": {
"companyId": 637323,
"type": "employee.joined",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2024-12-26T11:29:14.399997",
"version": "v2",
"data": {
"employeeId": "3332883894235038486"
}
}
}
}
},
"responses": {
"200": {
"description": "Webhook received successfully"
},
"400": {
"description": "Invalid webhook payload",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
}
},
"security": []
}
},
"employeeLeft": {
"post": {
"operationId": "post_webhook_employee-left",
"tags": [
"Employee data Webhooks"
],
"summary": "Employee terminated",
"description": "Triggered when an employee is set as terminated or on Garden leave\n(whichever occurs first), once the corresponding lifecycle entry becomes effective.\n\nLifecycle events are triggered automatically at midnight on the effective\ndate of the lifecycle table entry (according to the site's timezone).\n\nIn the right panel, open **Examples** and select **Payload Example** to see a real payload.\n",
"parameters": [
{
"name": "bob-signature",
"in": "header",
"required": true,
"description": "Base64-encoded signature sent with each webhook request. Use it to verify that the request came from Bob. To verify webhook authenticity, see How does Bob calculate the signature.",
"schema": {
"type": "string",
"example": "EQScIBkAtTKFW0ictgt5zzOsqIc2+xGEsM88jOdLuW4CM/a3gLEfrKV+IC5IHx0xbirzLKPIfaZjCGwzuiyI8w=="
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EmployeeLeftEvent"
},
"example": {
"companyId": 637323,
"type": "employee.left",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2024-12-26T11:29:14.399997",
"version": "v2",
"data": {
"employeeId": "3332883894235038486"
}
}
}
}
},
"responses": {
"200": {
"description": "Webhook received successfully"
},
"400": {
"description": "Invalid webhook payload",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
}
},
"security": []
}
},
"employeeActivated": {
"post": {
"operationId": "post_webhook_employee-activated",
"tags": [
"Employee data Webhooks"
],
"summary": "Employee activated",
"description": "Triggered when an employee's access is enabled, once the corresponding\nlifecycle entry becomes effective.\n\nIn the right panel, open **Examples** and select **Payload Example** to see a real payload.\n",
"parameters": [
{
"name": "bob-signature",
"in": "header",
"required": true,
"description": "Base64-encoded signature sent with each webhook request. Use it to verify that the request came from Bob. To verify webhook authenticity, see How does Bob calculate the signature.",
"schema": {
"type": "string",
"example": "EQScIBkAtTKFW0ictgt5zzOsqIc2+xGEsM88jOdLuW4CM/a3gLEfrKV+IC5IHx0xbirzLKPIfaZjCGwzuiyI8w=="
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EmployeeActivatedEvent"
},
"example": {
"companyId": 636192,
"type": "employee.activated",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2025-01-08T13:06:26.935613",
"version": "v2",
"data": {
"employeeId": "3332883854254932743"
}
}
}
}
},
"responses": {
"200": {
"description": "Webhook received successfully"
},
"400": {
"description": "Invalid webhook payload",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
}
},
"security": []
}
},
"employeeInactivated": {
"post": {
"operationId": "post_webhook_employee-inactivated",
"tags": [
"Employee data Webhooks"
],
"summary": "Employee inactivated",
"description": "Triggered when an employee is set to be on leave or terminated, once the\ncorresponding lifecycle entry becomes effective.\n\nThis event is not triggered if **Remain active** is selected when putting\nthe employee on leave.\n\nIn the right panel, open **Examples** and select **Payload Example** to see a real payload.\n",
"parameters": [
{
"name": "bob-signature",
"in": "header",
"required": true,
"description": "Base64-encoded signature sent with each webhook request. Use it to verify that the request came from Bob. To verify webhook authenticity, see How does Bob calculate the signature.",
"schema": {
"type": "string",
"example": "EQScIBkAtTKFW0ictgt5zzOsqIc2+xGEsM88jOdLuW4CM/a3gLEfrKV+IC5IHx0xbirzLKPIfaZjCGwzuiyI8w=="
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EmployeeInactivatedEvent"
},
"example": {
"companyId": 636192,
"type": "employee.inactivated",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2025-01-08T13:06:26.915964",
"version": "v2",
"data": {
"employeeId": "3332883854254932743"
}
}
}
}
},
"responses": {
"200": {
"description": "Webhook received successfully"
},
"400": {
"description": "Invalid webhook payload",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
}
},
"security": []
}
},
"employeeTemporaryLeave": {
"post": {
"operationId": "post_webhook_employee-temporary-leave",
"tags": [
"Employee data Webhooks"
],
"summary": "Employee on temporary leave",
"description": "Triggered when an employee is set to be on temporary leave, once the\ncorresponding lifecycle entry becomes effective.\n\nThis event is not triggered if **Remain active** is selected when putting\nthe employee on leave.\n\nIn the right panel, open **Examples** and select **Payload Example** to see a real payload.\n",
"parameters": [
{
"name": "bob-signature",
"in": "header",
"required": true,
"description": "Base64-encoded signature sent with each webhook request. Use it to verify that the request came from Bob. To verify webhook authenticity, see How does Bob calculate the signature.",
"schema": {
"type": "string",
"example": "EQScIBkAtTKFW0ictgt5zzOsqIc2+xGEsM88jOdLuW4CM/a3gLEfrKV+IC5IHx0xbirzLKPIfaZjCGwzuiyI8w=="
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EmployeeTemporaryLeaveEvent"
},
"example": {
"companyId": 636192,
"type": "employee.temporaryLeave",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2025-01-08T13:06:26.935613",
"version": "v2",
"data": {
"employeeId": "3332883854254932743"
}
}
}
}
},
"responses": {
"200": {
"description": "Webhook received successfully"
},
"400": {
"description": "Invalid webhook payload",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
}
},
"security": []
}
},
"tableEntryCreated": {
"post": {
"operationId": "post_webhook_table-entry-created",
"tags": [
"Employee data Webhooks"
],
"summary": "Table entry created",
"description": "Triggered when an entry is added to an employee's table (including\nout-of-the-box and custom tables).\n\nDoes not apply to Training, Equity, Positions, or Jobs tables.\n\nTo identify the row/entry when fetching using the API, use the property that appears in the payload for that table type:\n\n- **id** — Included only for non-historical tables (e.g. custom tables, bank accounts). Identifies the entry row. Omitted for historical tables.\n- **effectiveDate** — Included only for historical tables. Identifies the entry row for that table type. Omitted for non-historical tables.\n\nEach event includes exactly one of `effectiveDate` or `id` inside `data`, depending on whether the table is historical.\n\nTo learn more about table types, see Employee data modeling.\n\nWhen a table entry is created or updated, it may also update employee-level fields (e.g. derived or linked). In that case you will also receive an employee.updated event with the list of changed field IDs in fieldUpdates. Bank accounts and custom tables do not trigger this additional employee.updated event.\n\nIn the right panel, open **Examples** and select **Payload Example** to see a real payload.\n",
"parameters": [
{
"name": "bob-signature",
"in": "header",
"required": true,
"description": "Base64-encoded signature sent with each webhook request. Use it to verify that the request came from Bob. To verify webhook authenticity, see How does Bob calculate the signature.",
"schema": {
"type": "string",
"example": "EQScIBkAtTKFW0ictgt5zzOsqIc2+xGEsM88jOdLuW4CM/a3gLEfrKV+IC5IHx0xbirzLKPIfaZjCGwzuiyI8w=="
}
},
{
"name": "get-table",
"in": "header",
"required": false,
"description": "**Present only for custom tables.** The URL to call to read this table entry. For out-of-the-box tables the path is well known, but for custom tables this header provides the full URL with the table ID (e.g. `category_1716214820047__table_1716214839517`) already in the right place. Example: `https://api.hibob.com/v1/people/custom-tables/{employeeId}/{custom_table_id}`.",
"schema": {
"type": "string",
"example": "https://api.hibob.com/v1/people/custom-tables/3332883884017713938/category_1716214820047__table_1716214839517"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/TableEntryCreatedEvent"
},
"examples": {
"lifecycle": {
"summary": "Lifecycle",
"value": {
"companyId": 636192,
"type": "table.entry.created",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2025-01-08T13:06:26.915906",
"version": "v2",
"data": {
"employeeId": "3332883854254932743",
"tableId": "lifecycle",
"effectiveDate": "2025-01-08"
}
}
},
"work": {
"summary": "Work",
"value": {
"companyId": 636192,
"type": "table.entry.created",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2025-01-08T13:28:55.561963",
"version": "v2",
"data": {
"employeeId": "3332883904477528858",
"tableId": "work",
"effectiveDate": "2024-09-02"
}
}
},
"employment": {
"summary": "Employment",
"value": {
"companyId": 636192,
"type": "table.entry.created",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2025-01-08T13:30:41.592528",
"version": "v2",
"data": {
"employeeId": "3332883904477528858",
"tableId": "employment",
"effectiveDate": "2025-01-08"
}
}
},
"bankAccounts": {
"summary": "Bank accounts",
"value": {
"companyId": 636192,
"type": "table.entry.created",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2025-01-08T13:54:03.608759",
"version": "v2",
"data": {
"employeeId": "3332883904477528858",
"tableId": "bankAccounts",
"id": 6236350
}
}
},
"salary": {
"summary": "Payroll (salary)",
"value": {
"companyId": 636192,
"type": "table.entry.created",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2025-01-08T13:55:00.000000",
"version": "v2",
"data": {
"employeeId": "3332883904477528858",
"tableId": "salary",
"effectiveDate": "2025-01-08"
}
}
},
"customTable": {
"summary": "Custom table",
"value": {
"companyId": 636192,
"type": "table.entry.created",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2026-03-02T12:21:30.000000",
"version": "v2",
"data": {
"employeeId": "3460447757808959739",
"tableId": "category_1716214820047__table_1716214839517",
"id": 11542446
}
}
},
"address": {
"summary": "Address",
"value": {
"companyId": 636192,
"type": "table.entry.created",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2026-03-02T12:19:34.000000",
"version": "v2",
"data": {
"employeeId": "3460447757808959739",
"tableId": "address",
"effectiveDate": "2026-03-02"
}
}
},
"variablePay": {
"summary": "Variable Pay",
"value": {
"companyId": 636192,
"type": "table.entry.created",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2026-03-02T12:16:37.000000",
"version": "v2",
"data": {
"employeeId": "3460447757808959739",
"tableId": "variable",
"effectiveDate": "2026-03-02"
}
}
},
"entitlement": {
"summary": "Entitlement",
"value": {
"companyId": 636192,
"type": "table.entry.created",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2026-03-02T12:15:07.000000",
"version": "v2",
"data": {
"employeeId": "3460447757808959739",
"tableId": "entitlement",
"effectiveDate": "2026-03-03"
}
}
},
"deduction": {
"summary": "Deduction",
"value": {
"companyId": 636192,
"type": "table.entry.created",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2026-03-02T12:13:18.445371",
"version": "v2",
"data": {
"employeeId": "3460447757808959739",
"tableId": "deduction",
"effectiveDate": "2026-03-02"
}
}
}
}
}
}
},
"responses": {
"200": {
"description": "Webhook received successfully"
},
"400": {
"description": "Invalid webhook payload",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
}
},
"security": []
}
},
"tableEntryUpdated": {
"post": {
"operationId": "post_webhook_table-entry-updated",
"tags": [
"Employee data Webhooks"
],
"summary": "Table entry updated",
"description": "Triggered when an entry is updated in an employee's table (including\nout-of-the-box and custom tables).\n\nDoes not apply to Training, Equity, Positions, or Jobs tables.\n\nTo identify the row/entry when fetching using the API, use the property that appears in the payload for that table type:\n\n- **id** — Included only for non-historical tables (e.g. custom tables, bank accounts). Identifies the entry row. Omitted for historical tables.\n- **effectiveDate** — Included only for historical tables. Identifies the entry row for that table type. Omitted for non-historical tables.\n\nEach event includes exactly one of `effectiveDate` or `id` inside `data`, depending on whether the table is historical.\n\nTo learn more about table types, see Employee data modeling.\n\nWhen a table entry is created or updated, it may also update employee-level fields (e.g. derived or linked). In that case you will also receive an employee.updated event with the list of changed field IDs in fieldUpdates. Bank accounts and custom tables do not trigger this additional employee.updated event.\n\nIn the right panel, open **Examples** and select **Payload Example** to see a real payload.\n",
"parameters": [
{
"name": "bob-signature",
"in": "header",
"required": true,
"description": "Base64-encoded signature sent with each webhook request. Use it to verify that the request came from Bob. To verify webhook authenticity, see How does Bob calculate the signature.",
"schema": {
"type": "string",
"example": "EQScIBkAtTKFW0ictgt5zzOsqIc2+xGEsM88jOdLuW4CM/a3gLEfrKV+IC5IHx0xbirzLKPIfaZjCGwzuiyI8w=="
}
},
{
"name": "get-table",
"in": "header",
"required": false,
"description": "**Present only for custom tables.** The URL to call to read this table entry. For out-of-the-box tables the path is well known, but for custom tables this header provides the full URL with the table ID (e.g. `category_1716214820047__table_1716214839517`) already in the right place. Example: `https://api.hibob.com/v1/people/custom-tables/{employeeId}/{custom_table_id}`.",
"schema": {
"type": "string",
"example": "https://api.hibob.com/v1/people/custom-tables/3332883884017713938/category_1716214820047__table_1716214839517"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/TableEntryUpdatedEvent"
},
"examples": {
"lifecycle": {
"summary": "Lifecycle",
"value": {
"companyId": 636192,
"type": "table.entry.updated",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2025-01-08T13:06:27.000000",
"version": "v2",
"data": {
"employeeId": "3332883854254932743",
"tableId": "lifecycle",
"effectiveDate": "2025-01-08"
}
}
},
"work": {
"summary": "Work",
"value": {
"companyId": 636192,
"type": "table.entry.updated",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2025-01-08T13:28:05.816304",
"version": "v2",
"data": {
"employeeId": "3332883904477528858",
"tableId": "work",
"effectiveDate": "2024-03-27"
}
}
},
"employment": {
"summary": "Employment",
"value": {
"companyId": 636192,
"type": "table.entry.updated",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2025-01-08T13:51:00.000000",
"version": "v2",
"data": {
"employeeId": "3332883904477528858",
"tableId": "employment",
"effectiveDate": "2025-01-08"
}
}
},
"salary": {
"summary": "Payroll (salary)",
"value": {
"companyId": 636192,
"type": "table.entry.updated",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2025-01-08T13:55:45.055159",
"version": "v2",
"data": {
"employeeId": "3332883904477528858",
"tableId": "salary",
"effectiveDate": "2015-03-03"
}
}
},
"bankAccounts": {
"summary": "Bank accounts",
"value": {
"companyId": 636192,
"type": "table.entry.updated",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2025-01-08T13:54:10.000000",
"version": "v2",
"data": {
"employeeId": "3332883904477528858",
"tableId": "bankAccounts",
"id": 6236350
}
}
},
"customTable": {
"summary": "Custom table",
"value": {
"companyId": 636192,
"type": "table.entry.updated",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2026-03-02T12:21:31.349254",
"version": "v2",
"data": {
"employeeId": "3460447757808959739",
"tableId": "category_1716214820047__table_1716214839517",
"id": 11542446
}
}
},
"address": {
"summary": "Address",
"value": {
"companyId": 636192,
"type": "table.entry.updated",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2026-03-02T12:19:35.027449",
"version": "v2",
"data": {
"employeeId": "3460447757808959739",
"tableId": "address",
"effectiveDate": "2026-03-02"
}
}
},
"variablePay": {
"summary": "Variable Pay",
"value": {
"companyId": 636192,
"type": "table.entry.updated",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2026-03-02T12:16:38.749797",
"version": "v2",
"data": {
"employeeId": "3460447757808959739",
"tableId": "variable",
"effectiveDate": "2026-03-02"
}
}
},
"entitlement": {
"summary": "Entitlement",
"value": {
"companyId": 636192,
"type": "table.entry.updated",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2026-03-02T12:15:08.471303",
"version": "v2",
"data": {
"employeeId": "3460447757808959739",
"tableId": "entitlement",
"effectiveDate": "2026-03-03"
}
}
},
"deduction": {
"summary": "Deduction",
"value": {
"companyId": 636192,
"type": "table.entry.updated",
"triggeredBy": "3332883804594373380",
"triggeredAt": "2026-03-02T12:13:20.000000",
"version": "v2",
"data": {
"employeeId": "3460447757808959739",
"tableId": "deduction",
"effectiveDate": "2026-03-02"
}
}
}
}
}
}
},
"responses": {
"200": {
"description": "Webhook received successfully"
},
"400": {
"description": "Invalid webhook payload",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
}
},
"security": []
}
}
},
"paths": {
"/people/{id}/bank-accounts": {
"get": {
"operationId": "get_people-id-bank-accounts",
"tags": [
"Employee Tables"
],
"summary": "List employee's bank accounts",
"description": "
Returns a list of the bank accounts table entries for a given employee.
Important:
The Bank Account details are listed under the 'Financial' category in Bob's UI. They include basic bank account details, and may include also a list of bank accounts (if using more than a single bank account).
If you are using a list of Bank Accounts:
Use this endpoint will fetch the list of bank accounts.
Use the Read metadata for specific custom table endpoint and provide the table name: `bankAccounts` to fetch the table's metadata.
If you are using only a single Bank Account:
To fetch the basic bank account details (not the table), use the employee's search endpoint instead, and specify the fields you want to fetch (e.g. 'financial.bankName'). To learn more, see how to work with Fields, Custom fields and Lists.
See the '200' response for the body response.",
"parameters": [
{
"name": "id",
"in": "path",
"description": "The ID of the employee for whom you want to fetch the bank account entries. The employee ID is returned in the 'id' field when retrieving an employee's data.
For **testing purposes** you can obtain the Employee ID from the URL in the user interface.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "List of bank account entries.",
"headers": {
"X-Has-Restricted-Columns": {
"description": "Set to \"true\" when field-level permissions (FLP) has filtered columns from the response. Only present when FLP is enabled and the service user has partial column permissions. To learn more, see Field level permissions.",
"schema": {
"type": "string",
"enum": [
"true"
]
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BankAccountsEntries"
}
}
}
}
},
"security": [
{
"Basic": []
},
{
"Bearer": []
}
]
}
}
},
"components": {
"schemas": {
"WebhookEvent": {
"type": "object",
"description": "Base webhook event structure containing common webhook properties",
"properties": {
"companyId": {
"type": "number",
"description": "The company ID"
},
"type": {
"type": "string",
"description": "The event type (e.g., employee.created)"
},
"triggeredBy": {
"type": "string",
"description": "The backend-id of the employee that triggered the event, or 'system' for system-triggered events"
},
"triggeredAt": {
"type": "string",
"description": "The timestamp when the event occurred (ISO 8601-style string)"
},
"version": {
"type": "string",
"description": "The webhook version (e.g., v2)"
},
"data": {
"type": "object",
"description": "Event-specific payload; structure varies by event type"
}
},
"required": [
"companyId",
"type",
"triggeredBy",
"triggeredAt",
"version",
"data"
]
},
"EmployeeCreatedEventData": {
"type": "object",
"description": "Data payload for employee.created event",
"properties": {
"employeeId": {
"type": "string",
"description": "The unique identifier of the employee"
}
},
"required": [
"employeeId"
]
},
"EmployeeUpdatedEventData": {
"type": "object",
"description": "Data payload for employee.updated event",
"properties": {
"employeeId": {
"type": "string",
"description": "The unique identifier of the employee"
},
"fieldUpdates": {
"type": "array",
"description": "The field IDs that were explicitly changed (calculated fields are not included)",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The field ID (e.g., personal.birthDate)"
}
}
}
}
},
"required": [
"employeeId"
]
},
"EmployeeDeletedEventData": {
"type": "object",
"description": "Data payload for employee.deleted event",
"properties": {
"employeeId": {
"type": "string",
"description": "The unique identifier of the deleted employee"
},
"email": {
"type": "string",
"description": "The employee email (included since the record is no longer available after deletion)"
}
},
"required": [
"employeeId"
]
},
"EmployeeLifecycleEventData": {
"type": "object",
"description": "Data payload for lifecycle events (joined, left, activated, inactivated, temporaryLeave)",
"properties": {
"employeeId": {
"type": "string",
"description": "The unique identifier of the employee"
}
},
"required": [
"employeeId"
]
},
"TableEntryEventData": {
"type": "object",
"description": "Data payload for table.entry.created and table.entry.updated events. Historical tables include `effectiveDate` only; non-historical tables include numeric `id` only. The other identifier is omitted from the JSON when not applicable.",
"properties": {
"employeeId": {
"type": "string",
"description": "The unique identifier of the employee"
},
"tableId": {
"type": "string",
"description": "The table identifier (e.g., lifecycle, work, employment, salary, bankAccounts)"
},
"effectiveDate": {
"type": "string",
"format": "date",
"description": "Present for historical tables only. The effective date that identifies this row together with employeeId. Omitted for non-historical tables."
},
"id": {
"type": "integer",
"description": "Present for non-historical tables only. The numeric ID of this table row when reading via the API. Omitted for historical tables."
}
},
"required": [
"employeeId",
"tableId"
],
"oneOf": [
{
"required": [
"effectiveDate"
]
},
{
"required": [
"id"
]
}
]
},
"EmployeeCreatedEvent": {
"allOf": [
{
"$ref": "#/components/schemas/WebhookEvent"
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"employee.created"
],
"description": "Event type for employee created"
},
"data": {
"$ref": "#/components/schemas/EmployeeCreatedEventData"
}
}
}
]
},
"EmployeeUpdatedEvent": {
"allOf": [
{
"$ref": "#/components/schemas/WebhookEvent"
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"employee.updated"
],
"description": "Event type for employee field updated"
},
"data": {
"$ref": "#/components/schemas/EmployeeUpdatedEventData"
}
}
}
]
},
"EmployeeDeletedEvent": {
"allOf": [
{
"$ref": "#/components/schemas/WebhookEvent"
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"employee.deleted"
],
"description": "Event type for employee deleted"
},
"data": {
"$ref": "#/components/schemas/EmployeeDeletedEventData"
}
}
}
]
},
"EmployeeJoinedEvent": {
"allOf": [
{
"$ref": "#/components/schemas/WebhookEvent"
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"employee.joined"
],
"description": "Event type for employee joined (access granted)"
},
"data": {
"$ref": "#/components/schemas/EmployeeLifecycleEventData"
}
}
}
]
},
"EmployeeLeftEvent": {
"allOf": [
{
"$ref": "#/components/schemas/WebhookEvent"
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"employee.left"
],
"description": "Event type for employee terminated or on Garden leave"
},
"data": {
"$ref": "#/components/schemas/EmployeeLifecycleEventData"
}
}
}
]
},
"EmployeeActivatedEvent": {
"allOf": [
{
"$ref": "#/components/schemas/WebhookEvent"
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"employee.activated"
],
"description": "Event type for employee access enabled"
},
"data": {
"$ref": "#/components/schemas/EmployeeLifecycleEventData"
}
}
}
]
},
"EmployeeInactivatedEvent": {
"allOf": [
{
"$ref": "#/components/schemas/WebhookEvent"
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"employee.inactivated"
],
"description": "Event type for employee inactivated (on leave or terminated)"
},
"data": {
"$ref": "#/components/schemas/EmployeeLifecycleEventData"
}
}
}
]
},
"EmployeeTemporaryLeaveEvent": {
"allOf": [
{
"$ref": "#/components/schemas/WebhookEvent"
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"employee.temporaryLeave"
],
"description": "Event type for employee on temporary leave"
},
"data": {
"$ref": "#/components/schemas/EmployeeLifecycleEventData"
}
}
}
]
},
"TableEntryCreatedEvent": {
"allOf": [
{
"$ref": "#/components/schemas/WebhookEvent"
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"table.entry.created"
],
"description": "Event type for table entry created"
},
"data": {
"$ref": "#/components/schemas/TableEntryEventData"
}
}
}
]
},
"TableEntryUpdatedEvent": {
"allOf": [
{
"$ref": "#/components/schemas/WebhookEvent"
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"table.entry.updated"
],
"description": "Event type for table entry updated"
},
"data": {
"$ref": "#/components/schemas/TableEntryEventData"
}
}
}
]
},
"BankAccountsEntries": {
"type": "object",
"properties": {
"values": {
"type": "array",
"items": {
"$ref": "#/components/schemas/BankAccountsEntryForGet"
}
},
"restricted_columns": {
"$ref": "#/components/schemas/RestrictedColumnsMetadata"
}
}
},
"BankAccountsEntryForGet": {
"allOf": [
{
"$ref": "#/components/schemas/BankAccountsEntry"
},
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The unique identifier for the bank account entry."
},
"changedBy": {
"type": "string",
"description": "The employee ID of the person who last modified this entry."
}
}
}
]
},
"BankAccountsEntry": {
"type": "object",
"properties": {
"bankAccountType": {
"type": "string",
"enum": [
"Checking",
"Savings"
],
"description": "The list of bank accounts type comes with the above out-of-the-box values. To obtain additional user-defined values, you should fetch the list values call the Get all company lists Metadata API with `bankaccounttype` in the listname path parameter."
},
"routingNumber": {
"type": "string",
"description": "The routing number indicates what bank this account is held in. Relevant for US and Canada."
},
"accountNickname": {
"type": "string",
"description": "The nickname in Bob to easily identify and personalize this account in Online Banking."
},
"accountNumber": {
"type": "string",
"description": "The account number is the unique identifier at this bank."
},
"bankName": {
"type": "string",
"description": "The name of the specific financial institution."
},
"branchAddress": {
"type": "string",
"description": "The bank's address."
},
"bicOrSwift": {
"type": "string",
"description": "The SWIFT Address assigned to the bank in order to send automated international transfers."
},
"iban": {
"type": "string",
"description": "The international bank account number (IBAN) for international transfers."
},
"allocation": {
"type": "string",
"enum": [
"percent",
"amount",
"remaining"
],
"description": "The salary portion allocated for this account. It can be defined as a percentage of the salary, as a fixed amount, or to allocate all of the remaining funds. The list of possible values cannot be modified. The values that correspond to this field should be provided in the 'amount' field."
},
"amount": {
"type": "number",
"description": "Use this field to provide the values that correspond to the ‘allocation’ field. If allocation is 'percent' this value represents the percentage of the salary portion to allocate. If allocation is 'amount' this value represents the fixed amount of the salary portion to allocate. If allocation is 'remaining' then the amount field should remain empty. This indicates that all of the remaining funds will be allocated to this account."
},
"useForBonus": {
"type": "boolean",
"description": "An indication whether this bank account is used for bonuses."
}
}
},
"Error": {
"type": "object",
"properties": {
"key": {
"type": "string",
"description": "The unique identifier of the error."
},
"error": {
"type": "string",
"description": "A human readable error message."
}
}
},
"RestrictedColumnsMetadata": {
"type": "object",
"description": "Indicates which columns were filtered from the response due to field-level permissions (FLP). This object is only present when FLP is enabled for the company and the service user has partial column permissions. To learn more, see Field level permissions.",
"properties": {
"no_view_permission": {
"type": "array",
"items": {
"type": "string"
},
"description": "Columns filtered because the service user lacks View permission for these fields."
},
"no_view_history_permission": {
"type": "array",
"items": {
"type": "string"
},
"description": "Columns filtered because the service user lacks View History permission. Only present for historical tables (work, employment, salaries, lifecycle)."
}
}
}
},
"securitySchemes": {
"Basic": {
"type": "http",
"scheme": "basic",
"description": "Basic HTTP authentication using service user credentials"
},
"Bearer": {
"type": "http",
"scheme": "bearer",
"bearerFormat": "OAuth 2.0",
"description": "OAuth 2.0 authentication using an Access Token is available for registered partners only. Try It! does not support the full HiBob OAuth flow. You can follow these steps to complete the OAuth 2.0 flow in Postman and then paste the token here."
}
}
}
}
```