---
title: "Retrieve stock grants"
method: GET
path: "/v1/org/{orgId}/stockgrant"
tags: ["stockgrant"]
---

# Retrieve stock grants

`GET /v1/org/{orgId}/stockgrant`

## Path parameters

- `orgId` string, required

## Query parameters

- `personId` string
- `fromDate` string, date
- `untilDate` string, date
- `from` string
- `limit` integer
- `returnAccess` string

## Response `200`

successful operation

- ResultsStockGrantEntity
  - `data` StockGrantEntity[], required
    - `id` string, required — globally unique id of stock grant
    - `orgId` string, required — org that the stock grant belongs to
    - `personId` string, required — person granted the stock
    - `externalId` string — external identifier, if grant synced from external system
    - `stock` string, required — ticker symbol of this stock
    - `date` string, date, required — date of grant
    - `vestStartDate` string, date — vesting start date of grant
    - `expireDate` string, date — expiration date of grant
    - `shares` number, required — number of shares granted
    - `price` number, required — per share strike price
    - `type` 'ISO' | 'NSO' | 'RSU' | 'SAR' | 'PERFORMANCE_SHARES' | 'PHANTOM_STOCK' | 'RSA', required — type of grant
    - `vestSchedule` string, required — vesting schedule
    - `originalPrice` number — original per share value of stock (grant price at time of issue)
    - `currentPrice` number — current per share value of stock
    - `vestedShares` number — current number of shares vested
    - `vestedSharesNextYear` number — number of shares vested one year from today
    - `vestedSharesByDate` object — number of shares vested, by future date
    - `vestEndDate` string, date — vesting end date
    - `cancelDate` string, date — cancellation date
    - `terminationDate` string, date — termination date — vesting freezes on this date when the holder separates
    - `lastExercisableDate` string, date — last date on which vested shares can be exercised; after this the grant is forfeited
    - `details` string — details of the grant (arbitrary text)
    - `createId` string — created by user id
    - `createAt` string — created timestamp
    - `updateAt` string — updated timestamp
    - `updateId` string — updated by user id
    - `deleteId` string — deleted by user id
    - `deleteAt` string — deleted timestamp
  - `next` string
  - `access` ResultsAccess[]
    - `ids` string[]
    - `allowed` AccessAction[], required
      - `action` string, required
      - `fields` string[]
      - `types` string[]

## Other responses

- `400` — bad request
- `401` — not authorized
- `404` — not found
- `500` — Not Implemented

---

[API](https://skmtc.net/charthop/apis/charthop-api.md) · [All operations](https://skmtc.net/charthop/apis/charthop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/charthop/charthop-api/versions/50a1edd6b27e/schema)