List equity grant total expense records

GET

/equity-expenses

GET

/rest/equity-expenses

$ curl -G https://api.letsdeel.com/rest/equity-expenses \
>      -H "Authorization: Bearer <token>" \
>      -d limit=50 \
>      -d cursor=eyJzb3J0VmFsdWUiOiI5MDAxIiwiaWQiOiJhMWIyYzNkNC1lNWY2LTc4OTAtYWJjZC1lZjEyMzQ1Njc4OTAifQ \
>      -d employee_number=9001 \
>      -d employee_grant_number=ES-0001 \
>      -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       "plan_name": "2020 Stock Plan",
7       "award_type": "Options (NQ)",
8       "created_at": "2026-08-13T09:01:02.000Z",
9       "grant_date": "2022-06-18",
10       "grant_name": "06/18/2022 - NQSO - $4.7",
11       "updated_at": "2026-08-13T09:01:02.000Z",
12       "base_shares": 1000,
13       "grant_price": 4.7,
14       "base_expense": 4700,
15       "factor_shares": 5.5,
16       "source_file_id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
17       "employee_number": "9001",
18       "hris_profile_id": 4821,
19       "occurrence_index": 1,
20       "valuation_status": "Active",
21       "actual_forfeitures": 1000,
22       "fair_value_per_share": 4.7,
23       "last_seen_dataset_id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
24       "unvested_repurchased": 1000,
25       "employee_grant_number": "ES-0001",
26       "estimated_forfeitures": 1000,
27       "forfeiture_rate_percent": 5.5,
28       "total_estimated_expense": 4700,
29       "actual_performance_factor": 5.5,
30       "estimated_performance_factor": 5.5,
31       "total_actual_expense_to_accrue": 4700,
32       "total_actual_shares_to_expense": 4700,
33       "total_estimated_shares_to_expense": 4700
34     }
35   ],
36   "has_more": false,
37   "next_cursor": "eyJzb3J0VmFsdWUiOiI5MDAxIiwiaWQiOiJhMWIyYzNkNC1lNWY2LTc4OTAtYWJjZC1lZjEyMzQ1Njc4OTAifQ=="
38 }

Retrieves the total share-based compensation expense recognised per equity grant in an organization, as ingested from Shareworks. Use it at period close to tie the equity expense in the ledger back to the individual grants that produced it. Each record reflects the most recently ingested reporting period; earlier periods are overwritten, so this is not a period history. Requires the equities.view permission at the organization level.

Token scopes: equities:read

Retrieves the total share-based compensation expense recognised per equity grant in an organization, as ingested from Shareworks. Use it at period close to tie the equity expense in the ledger back to the individual grants that produced it. Each record reflects the most recently ingested reporting period; earlier periods are overwritten, so this is not a period history. 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.

employee_grant_numberstringOptional<=100 characters

Only return records for this exact Shareworks grant 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 grant total expense records returned successfully.

datalist of objects

Page of total expense records, one per grant occurrence.

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'