List equity awards granted

GET

/equity-awards

GET

/rest/equity-awards

$ curl -G https://api.letsdeel.com/rest/equity-awards \
>      -H "Authorization: Bearer <token>" \
>      -d limit=50 \
>      -d cursor=eyJzb3J0VmFsdWUiOiI5MDAxIiwiaWQiOiJhMWIyYzNkNC1lNWY2LTc4OTAtYWJjZC1lZjEyMzQ1Njc4OTAifQ \
>      -d employee_number=9001 \
>      -d grant_date_from=2026-01-01 \
>      -d grant_date_to=2026-12-31

1 {
2   "data": [
3     {
4       "id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
5       "row_hash": "9f2c1a7e4b6d8f0a2c4e6b8d0f2a4c6e8b0d2f4a6c8e0b2d4f6a8c0e2b4d6f8a",
6       "last_name": "Doe",
7       "plan_name": "2020 Stock Plan",
8       "total_fmv": 4.7,
9       "award_name": "NQSO Standard",
10       "created_at": "2026-08-13T09:01:02.000Z",
11       "first_name": "Jane",
12       "grant_date": "2022-06-18",
13       "grant_name": "06/18/2022 - NQSO - $4.7",
14       "updated_at": "2026-08-13T09:01:02.000Z",
15       "grant_price": 4.7,
16       "employee_type": "Employee",
17       "grant_quantity": 1000,
18       "source_file_id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
19       "employee_number": "9001",
20       "hris_profile_id": 4821,
21       "state_exemption": "Rule 701",
22       "occurrence_index": 1,
23       "federal_exemption": "Rule 701",
24       "is_under_rule_701": "Yes",
25       "state_of_exemption": "Rule 701",
26       "vest_schedule_name": "4 Year Monthly",
27       "vesting_start_date": "2022-06-18",
28       "allow_early_exercise": "Yes",
29       "compensation_benefit": 4700,
30       "last_seen_dataset_id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
31       "state_exemption_date": "2022-06-18",
32       "total_exercise_price": 4.7,
33       "federal_exemption_date": "2022-06-18",
34       "fmv_per_share_at_grant_date": 4.7
35     }
36   ],
37   "has_more": false,
38   "next_cursor": "eyJzb3J0VmFsdWUiOiI5MDAxIiwiaWQiOiJhMWIyYzNkNC1lNWY2LTc4OTAtYWJjZC1lZjEyMzQ1Njc4OTAifQ=="
39 }

Retrieves the equity awards an organization has granted, as ingested from Shareworks, in ascending employee_number order. Use it to reconcile what was granted to whom, with the grant quantity, price and fair market value at the grant date. This dataset identifies a grant by name and date rather than by grant number, so several records can share one employee and grant name; occurrence_index separates them. Requires the equities.view permission at the organization level.

Token scopes: equities:read

Retrieves the equity awards an organization has granted, as ingested from Shareworks, in ascending employee_number order. Use it to reconcile what was granted to whom, with the grant quantity, price and fair market value at the grant date. This dataset identifies a grant by name and date rather than by grant number, so several records can share one employee and grant name; occurrence_index separates them. Requires the `equities.view` permission at the organization level. **Token scopes**: `equities:read`

Authentication

AuthorizationBearer

Authentication

The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail.

$ curl -X GET 'https://api.deel.training/rest/v2/contracts' \
>   -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

## Authentication The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail. ```curl curl -X GET 'https://api.deel.training/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication)

AuthorizationBearer

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Query parameters

limitintegerOptional1-100Defaults to 50

Maximum number of records to return in this page.

cursorstringOptional<=2048 characters

Opaque pagination cursor returned as next_cursor by a previous response. Omit to fetch the first page.

employee_numberstringOptional<=64 characters

Only return records for this exact Shareworks employee number.

grant_date_fromstringOptionalformat: "date"

Only return records with a grant_date on or after this date (inclusive), in YYYY-MM-DD format.

grant_date_tostringOptionalformat: "date"

Only return records with a grant_date on or before this date (inclusive), in YYYY-MM-DD format.

Response

List equity awards granted returned successfully.

datalist of objects

Page of granted equity award records, one per reported award row.

has_moreboolean

Whether another page of results is available.

next_cursorstring or null

Cursor for the next page. Null when has_more is false.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl -X GET 'https://api.deel.training/rest/v2/contracts' \
>	-H 'Authorization: Bearer YOUR-TOKEN-HERE'