List equity grant valuations

GET

/equity-valuations

GET

/rest/equity-valuations

$ curl -G https://api.letsdeel.com/rest/equity-valuations \
>      -H "Authorization: Bearer <token>" \
>      -d limit=50 \
>      -d cursor=eyJzb3J0VmFsdWUiOiI5MDAxIiwiaWQiOiJhMWIyYzNkNC1lNWY2LTc4OTAtYWJjZC1lZjEyMzQ1Njc4OTAifQ \
>      -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       "grant_price": 4.7,
13       "market_price": 4.7,
14       "expected_life": 1000,
15       "source_file_id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
16       "valuation_type": "Standard",
17       "volatility_type": "Standard",
18       "occurrence_index": 1,
19       "original_granted": 1000,
20       "expected_life_type": "Standard",
21       "original_vest_date": "2022-06-18",
22       "volatility_percent": 5.5,
23       "amortization_method": "Black-Scholes",
24       "dividend_yield_type": "Standard",
25       "risk_free_rate_type": "Standard",
26       "fair_value_per_share": 4.7,
27       "last_seen_dataset_id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
28       "employee_grant_number": "ES-0001",
29       "risk_free_rate_source": "Reported value",
30       "dividend_yield_percent": 5.5,
31       "risk_free_rate_percent": 5.5,
32       "expense_valuation_model": "Black-Scholes",
33       "forfeiture_rate_percent": 5.5,
34       "original_performance_rule": "Reported value",
35       "expense_amortization_start_date": "2022-06-18",
36       "forfeiture_rate_calculation_method": "Black-Scholes"
37     }
38   ],
39   "has_more": false,
40   "next_cursor": "eyJzb3J0VmFsdWUiOiI5MDAxIiwiaWQiOiJhMWIyYzNkNC1lNWY2LTc4OTAtYWJjZC1lZjEyMzQ1Njc4OTAifQ=="
41 }

Retrieves the expense valuation inputs for each equity grant in an organization, as ingested from Shareworks, in ascending employee_grant_number order. Use it to reproduce or audit a grant expense figure: it carries the valuation model, amortization method, fair value per share, forfeiture rate, and the volatility, expected life, risk-free rate and dividend yield assumptions behind them. Requires the equities.view permission at the organization level.

Token scopes: equities:read

Retrieves the expense valuation inputs for each equity grant in an organization, as ingested from Shareworks, in ascending employee_grant_number order. Use it to reproduce or audit a grant expense figure: it carries the valuation model, amortization method, fair value per share, forfeiture rate, and the volatility, expected life, risk-free rate and dividend yield assumptions behind 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_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 valuations returned successfully.

datalist of objects

Page of grant valuation 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'