---
title: "List equity grants for a list of employees"
method: GET
path: "/bulk/people/equities"
tags: ["Employee Tables"]
---

# List equity grants for a list of employees

`GET /bulk/people/equities`

## Request

- Base URL: `https://api.hibob.com/v1`
- URL: `https://api.hibob.com/v1/bulk/people/equities`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

Returns equity table entries for all employees or a specific list of employees. Each entry in <code>values</code> uses the same schema as <a href="https://apidocs.hibob.com/reference/get_people-id-equities" target="_blank">List the employee's equity grants</a>.<br /> <br /> You can fetch employee IDs using the <a href="https://apidocs.hibob.com/reference/post_people-search" target="_blank">People search</a> endpoint.<br /> <br /> **<b>Required permissions</b>** <br /> People's Data &gt; People's fields &gt; Payroll / Equity — View (or the equivalent table-level permission under People's fields).<br /> **For the employees**: People's Data &gt; Access data for &gt; Make sure the employees are in the list. Employees that are not listed and were specifically requested will be listed under <code>errors</code> in the response. <br /> <br /> **<b>Pagination</b>** <br /> This endpoint uses cursor-based pagination to handle large numbers of table entries. To learn more, see <a href="https://apidocs.hibob.com/docs/pagination" target="_blank">Pagination in Bob's API</a>

## Query parameters

- `limit` number
- `cursor` string
- `employeeIds` string
- `includeArchived` boolean

## Response `200`

Equity table entries.

- BulkEquitiesTableResponse: Cursor-paginated bulk response for equity table entries.
  - `results` object[]: Equity table entries grouped by employee.
    - `employeeId` string: Employee ID these equity entries belong to.
    - `values` EquityEntry[]: Equity entries for this employee on the current page.
      - `id` integer: The ID of the equity table entry.
      - `quantity` number, double, required: The number of equities granted.
      - `equityType` string, required: The type of the grant.
      - `vestingCommencementDate` string, date, nullable: Vesting commencement date.
      - `consentNumber` string, nullable: Consent number.
      - `grantDate` string, date, nullable: Date the equity was granted.
      - `optionExpiration` string, date, nullable: Date the options expire.
      - `exercisePrice` CurrencyValue
        - `value` number, double, required
        - `currency` string, required: Three-letter currency code.
      - `vestingTerm` string, nullable: Terms for exercising this grant.
      - `taxPlan` string, nullable: Tax plan associated with the grant.
      - `specialTerms` string, nullable: Special terms associated with the grant.
      - `grantType` string, nullable: Grant type. One of: Initial Grant, Merit Grant
      - `vestingSchedule` integer, nullable: The vesting schedule ID assigned to this grant.
      - `grantNumber` number, double, nullable: The Grant number for employee.
      - `grantStatus` string, nullable: Grant status. one of: Granted, Pending Approval
      - `grantAmount` CurrencyValue
        - `value` number, double, required
        - `currency` string, required: Three-letter currency code.
      - `change` object: Details of the last change to this entry.
        - `reason` string: The reason for this change.
        - `changedBy` string: Display name of the user who made the change.
        - `changedById` string, nullable: Backend ID of the user who made the change.
      - `customColumns` object: Custom column values for this entry, keyed by column id.
  - `response_metadata` object: Pagination metadata for the bulk response.
    - `next_cursor` string, nullable: Contains a string value if there is a 'next' page of data. `null` if there is no more data. Use this value as the `cursor` parameter for pagination to get the next page.
  - `errors` object[]: Permission errors for employees that were requested but could not be read. In the live JSON payload this is an object keyed by employee ID (`{ "<employeeId>": { "error", "message" } }`); documented as an array of entries (same pattern as other bulk employee-table responses) so the schema stays strict without `additionalProperties`.
    - `employeeId` string: Employee ID that could not be accessed.
    - `error` string: Machine-readable error code.
    - `message` string: Human-readable explanation of the permission error.
  - `restricted_columns` RestrictedColumnsMetadata: Indicates which columns were filtered from the response due to field-level permissions. This object is only present when the service user has partial column permissions. To learn more, see <a href="https://apidocs.hibob.com/docs/employee-data-api-field-level-permissions#detecting-restricted-columns-in-api-responses" target="_blank">Field level permissions</a>.
    - `no_view_permission` string[]: Columns filtered because the service user lacks View permission for these fields.
    - `no_view_history_permission` string[]: Columns filtered because the service user lacks View History permission. Only present for historical tables (work, employment, salaries, lifecycle).

## Other responses

- `400`: Bad request.
- `403`: Forbidden. The service user does not have permissions to access this table or employees. Check the permissions as explained in the endpoint description.

## Changes

- **2026-11-03** `9ac25373a355`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hibob/apis/employee-data-api/changes/bulk/people/equities/get.md)

---

[API](https://skmtc.dev/hibob/apis/employee-data-api.md) - [All operations](https://skmtc.dev/hibob/apis/employee-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hibob/apis/employee-data-api/revisions/9ac25373a355?raw)