Deel: List equity option ledger entries — 200 response body — data item
List equity option ledger entries: 200 response body, field data / item. Complete fields and constraints for contract 2026-10-27.
API reference · Contract 2026-10-27
SDK schema: List equity option ledger entries — 200 response body — data item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
carta_grant_acceptance_date | JSON | Required within parent | |
carta_grant_acceptance_date (anyOf 1) | string | Alternative | Carta - Grant Acceptance Date, as reported by the ingested file. Format: date |
carta_grant_acceptance_date (anyOf 2) | null | Alternative | Carta - Grant Acceptance Date, as reported by the ingested file. Format: date |
compensation_benefit | JSON | Required within parent | |
compensation_benefit (anyOf 1) | JSON | Alternative | |
compensation_benefit (anyOf 1) (anyOf 1) | number | Alternative | Compensation benefit amount, as reported by the ingested file. Format: double |
compensation_benefit (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
compensation_benefit (anyOf 2) | null | Alternative | Compensation benefit amount, as reported by the ingested file. Format: double |
created_at | string | Required within parent | Timestamp this record was first ingested. Format: date-time |
early_exercise_allowed | JSON | Required within parent | |
early_exercise_allowed (anyOf 1) | string | Alternative | Whether early exercise is allowed, as reported by the ingested file (verbatim text, e.g. Yes/No). |
early_exercise_allowed (anyOf 2) | null | Alternative | Whether early exercise is allowed, as reported by the ingested file (verbatim text, e.g. Yes/No). |
employee_grant_number | string | Required within parent | Shareworks grant number for this employee, as reported by the ingested file. |
employee_number | JSON | Required within parent | |
employee_number (anyOf 1) | string | Alternative | Shareworks employee number, as reported by the ingested file. The intended join key for this record. Some values are non-numeric for legacy or masked records. |
employee_number (anyOf 2) | null | Alternative | Shareworks employee number, as reported by the ingested file. The intended join key for this record. Some values are non-numeric for legacy or masked records. |
exercise_price_per_share | JSON | Required within parent | |
exercise_price_per_share (anyOf 1) | JSON | Alternative | |
exercise_price_per_share (anyOf 1) (anyOf 1) | number | Alternative | Exercise price per share, as reported by the ingested file. Format: double |
exercise_price_per_share (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
exercise_price_per_share (anyOf 2) | null | Alternative | Exercise price per share, as reported by the ingested file. Format: double |
expire_date | JSON | Required within parent | |
expire_date (anyOf 1) | string | Alternative | Grant expiration date, as reported by the ingested file. Format: date |
expire_date (anyOf 2) | null | Alternative | Grant expiration date, as reported by the ingested file. Format: date |
federal_exemption | JSON | Required within parent | |
federal_exemption (anyOf 1) | string | Alternative | Federal exemption, as reported by the ingested file. |
federal_exemption (anyOf 2) | null | Alternative | Federal exemption, as reported by the ingested file. |
first_name | JSON | Required within parent | |
first_name (anyOf 1) | string | Alternative | Employee first name, as reported by the ingested file. |
first_name (anyOf 2) | null | Alternative | Employee first name, as reported by the ingested file. |
fmv_per_share_at_grant_date | JSON | Required within parent | |
fmv_per_share_at_grant_date (anyOf 1) | JSON | Alternative | |
fmv_per_share_at_grant_date (anyOf 1) (anyOf 1) | number | Alternative | Fair market value per share at grant date, as reported by the ingested file. Format: double |
fmv_per_share_at_grant_date (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
fmv_per_share_at_grant_date (anyOf 2) | null | Alternative | Fair market value per share at grant date, as reported by the ingested file. Format: double |
formatted_home_address | JSON | Required within parent | |
formatted_home_address (anyOf 1) | string | Alternative | Formatted home address, as reported by the ingested file. |
formatted_home_address (anyOf 2) | null | Alternative | Formatted home address, as reported by the ingested file. |
grant_agreement_template_name | JSON | Required within parent | |
grant_agreement_template_name (anyOf 1) | string | Alternative | Grant agreement template name, as reported by the ingested file. |
grant_agreement_template_name (anyOf 2) | null | Alternative | Grant agreement template name, as reported by the ingested file. |
grant_date | JSON | Required within parent | |
grant_date (anyOf 1) | string | Alternative | Date the grant was issued, as reported by the ingested file. Format: date |
grant_date (anyOf 2) | null | Alternative | Date the grant was issued, as reported by the ingested file. Format: date |
grant_name | JSON | Required within parent | |
grant_name (anyOf 1) | string | Alternative | Grant name, as reported by the ingested file. |
grant_name (anyOf 2) | null | Alternative | Grant name, as reported by the ingested file. |
grant_reason | JSON | Required within parent | |
grant_reason (anyOf 1) | string | Alternative | Grant reason, as reported by the ingested file. |
grant_reason (anyOf 2) | null | Alternative | Grant reason, as reported by the ingested file. |
grant_type | JSON | Required within parent | |
grant_type (anyOf 1) | string | Alternative | Grant type (e.g. Options (NQ)), as reported by the ingested file. |
grant_type (anyOf 2) | null | Alternative | Grant type (e.g. Options (NQ)), as reported by the ingested file. |
hris_profile_id | JSON | Required within parent | |
hris_profile_id (anyOf 1) | JSON | Alternative | |
hris_profile_id (anyOf 1) (anyOf 1) | integer | Alternative | Matched HRIS profile id, if employee_number could be resolved to one. Null when unmatched, or when employee_number is non-numeric or blank. |
hris_profile_id (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
hris_profile_id (anyOf 2) | null | Alternative | Matched HRIS profile id, if employee_number could be resolved to one. Null when unmatched, or when employee_number is non-numeric or blank. |
id | string | Required within parent | The unique identifier of the record. Format: uuid |
is_under_rule_701 | JSON | Required within parent | |
is_under_rule_701 (anyOf 1) | string | Alternative | Whether the grant is under Rule 701, as reported by the ingested file (verbatim text, e.g. Yes/No). |
is_under_rule_701 (anyOf 2) | null | Alternative | Whether the grant is under Rule 701, as reported by the ingested file (verbatim text, e.g. Yes/No). |
iso_csop_disqualification_date | JSON | Required within parent | |
iso_csop_disqualification_date (anyOf 1) | string | Alternative | ISO/CSOP disqualification date, as reported by the ingested file. Format: date |
iso_csop_disqualification_date (anyOf 2) | null | Alternative | ISO/CSOP disqualification date, as reported by the ingested file. Format: date |
last_name | JSON | Required within parent | |
last_name (anyOf 1) | string | Alternative | Employee last name, as reported by the ingested file. |
last_name (anyOf 2) | null | Alternative | Employee last name, as reported by the ingested file. |
last_seen_dataset_id | JSON | Required within parent | |
last_seen_dataset_id (anyOf 1) | string | Alternative | Identifier of the most recent ingested dataset in which this record still appeared. Null for records ingested before dataset tracking began. Format: uuid |
last_seen_dataset_id (anyOf 2) | null | Alternative | Identifier of the most recent ingested dataset in which this record still appeared. Null for records ingested before dataset tracking began. Format: uuid |
middle_name | JSON | Required within parent | |
middle_name (anyOf 1) | string | Alternative | Employee middle name, as reported by the ingested file. |
middle_name (anyOf 2) | null | Alternative | Employee middle name, as reported by the ingested file. |
no_of_shares_granted | JSON | Required within parent | |
no_of_shares_granted (anyOf 1) | JSON | Alternative | |
no_of_shares_granted (anyOf 1) (anyOf 1) | number | Alternative | Number of shares/units granted, as reported by the ingested file. Format: double |
no_of_shares_granted (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
no_of_shares_granted (anyOf 2) | null | Alternative | Number of shares/units granted, as reported by the ingested file. Format: double |
no_of_shares_unvested | JSON | Required within parent | |
no_of_shares_unvested (anyOf 1) | JSON | Alternative | |
no_of_shares_unvested (anyOf 1) (anyOf 1) | number | Alternative | Number of shares unvested, as reported by the ingested file. Format: double |
no_of_shares_unvested (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
no_of_shares_unvested (anyOf 2) | null | Alternative | Number of shares unvested, as reported by the ingested file. Format: double |
no_of_shares_vested | JSON | Required within parent | |
no_of_shares_vested (anyOf 1) | JSON | Alternative | |
no_of_shares_vested (anyOf 1) (anyOf 1) | number | Alternative | Number of shares vested, as reported by the ingested file. Format: double |
no_of_shares_vested (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
no_of_shares_vested (anyOf 2) | null | Alternative | Number of shares vested, as reported by the ingested file. Format: double |
notes | JSON | Required within parent | |
notes (anyOf 1) | string | Alternative | Free-form notes, as reported by the ingested file. |
notes (anyOf 2) | null | Alternative | Free-form notes, as reported by the ingested file. |
occurrence_index | JSON | Required within parent | |
occurrence_index (anyOf 1) | integer | Alternative | Discriminates several records the source file reports for the same natural key. Starts at 1, in the order the rows appear in the file. |
occurrence_index (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
outstanding_exercisable | JSON | Required within parent | |
outstanding_exercisable (anyOf 1) | JSON | Alternative | |
outstanding_exercisable (anyOf 1) (anyOf 1) | number | Alternative | Outstanding exercisable shares, as reported by the ingested file. Format: double |
outstanding_exercisable (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
outstanding_exercisable (anyOf 2) | null | Alternative | Outstanding exercisable shares, as reported by the ingested file. Format: double |
outstanding_unvested | JSON | Required within parent | |
outstanding_unvested (anyOf 1) | JSON | Alternative | |
outstanding_unvested (anyOf 1) (anyOf 1) | number | Alternative | Outstanding unvested shares, as reported by the ingested file. Format: double |
outstanding_unvested (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
outstanding_unvested (anyOf 2) | null | Alternative | Outstanding unvested shares, as reported by the ingested file. Format: double |
outstanding_vested | JSON | Required within parent | |
outstanding_vested (anyOf 1) | JSON | Alternative | |
outstanding_vested (anyOf 1) (anyOf 1) | number | Alternative | Outstanding vested shares, as reported by the ingested file. Format: double |
outstanding_vested (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
outstanding_vested (anyOf 2) | null | Alternative | Outstanding vested shares, as reported by the ingested file. Format: double |
plan_name | JSON | Required within parent | |
plan_name (anyOf 1) | string | Alternative | Equity plan name, as reported by the ingested file. |
plan_name (anyOf 2) | null | Alternative | Equity plan name, as reported by the ingested file. |
preferred_share_price | JSON | Required within parent | |
preferred_share_price (anyOf 1) | JSON | Alternative | |
preferred_share_price (anyOf 1) (anyOf 1) | number | Alternative | Preferred share price, as reported by the ingested file. Format: double |
preferred_share_price (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
preferred_share_price (anyOf 2) | null | Alternative | Preferred share price, as reported by the ingested file. Format: double |
row_hash | string | Required within parent | Hash of the reported values on this record. Compare it between syncs to detect a change without diffing every field. |
section_102_disqualification_date | JSON | Required within parent | |
section_102_disqualification_date (anyOf 1) | string | Alternative | ”102 Disqualification date” in the source file (Section 102 of the Israeli tax ordinance). Format: date |
section_102_disqualification_date (anyOf 2) | null | Alternative | ”102 Disqualification date” in the source file (Section 102 of the Israeli tax ordinance). Format: date |
shares_cancelled | JSON | Required within parent | |
shares_cancelled (anyOf 1) | JSON | Alternative | |
shares_cancelled (anyOf 1) (anyOf 1) | number | Alternative | Shares cancelled, as reported by the ingested file. Format: double |
shares_cancelled (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
shares_cancelled (anyOf 2) | null | Alternative | Shares cancelled, as reported by the ingested file. Format: double |
shares_exercised_released | JSON | Required within parent | |
shares_exercised_released (anyOf 1) | JSON | Alternative | |
shares_exercised_released (anyOf 1) (anyOf 1) | number | Alternative | Shares exercised/released, as reported by the ingested file. Format: double |
shares_exercised_released (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
shares_exercised_released (anyOf 2) | null | Alternative | Shares exercised/released, as reported by the ingested file. Format: double |
shares_expired | JSON | Required within parent | |
shares_expired (anyOf 1) | JSON | Alternative | |
shares_expired (anyOf 1) (anyOf 1) | number | Alternative | Shares expired, as reported by the ingested file. Format: double |
shares_expired (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
shares_expired (anyOf 2) | null | Alternative | Shares expired, as reported by the ingested file. Format: double |
shares_outstanding | JSON | Required within parent | |
shares_outstanding (anyOf 1) | JSON | Alternative | |
shares_outstanding (anyOf 1) (anyOf 1) | number | Alternative | Shares outstanding, as reported by the ingested file. Format: double |
shares_outstanding (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
shares_outstanding (anyOf 2) | null | Alternative | Shares outstanding, as reported by the ingested file. Format: double |
shares_repurchased | JSON | Required within parent | |
shares_repurchased (anyOf 1) | JSON | Alternative | |
shares_repurchased (anyOf 1) (anyOf 1) | number | Alternative | Shares repurchased, as reported by the ingested file. Format: double |
shares_repurchased (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
shares_repurchased (anyOf 2) | null | Alternative | Shares repurchased, as reported by the ingested file. Format: double |
shares_subject_to_repurchase | JSON | Required within parent | |
shares_subject_to_repurchase (anyOf 1) | JSON | Alternative | |
shares_subject_to_repurchase (anyOf 1) (anyOf 1) | number | Alternative | Shares subject to repurchase, as reported by the ingested file. Format: double |
shares_subject_to_repurchase (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
shares_subject_to_repurchase (anyOf 2) | null | Alternative | Shares subject to repurchase, as reported by the ingested file. Format: double |
shareworks_grant_agreement_agreement_date | JSON | Required within parent | |
shareworks_grant_agreement_agreement_date (anyOf 1) | string | Alternative | Shareworks - Grant Agreement - Agreement Date, as reported by the ingested file. Format: date |
shareworks_grant_agreement_agreement_date (anyOf 2) | null | Alternative | Shareworks - Grant Agreement - Agreement Date, as reported by the ingested file. Format: date |
shareworks_grant_agreement_print_instant | JSON | Required within parent | |
shareworks_grant_agreement_print_instant (anyOf 1) | string | Alternative | Shareworks - Grant Agreement - Print Instant, as reported by the ingested file. |
shareworks_grant_agreement_print_instant (anyOf 2) | null | Alternative | Shareworks - Grant Agreement - Print Instant, as reported by the ingested file. |
source_file_id | string | Required within parent | Identifier of the ingested Shareworks report file this record was last upserted from. Format: uuid |
split_employee_grant_number | JSON | Required within parent | |
split_employee_grant_number (anyOf 1) | string | Alternative | Split Employee Grant Number, as reported by the ingested file. |
split_employee_grant_number (anyOf 2) | null | Alternative | Split Employee Grant Number, as reported by the ingested file. |
state_exemption | JSON | Required within parent | |
state_exemption (anyOf 1) | string | Alternative | State exemption, as reported by the ingested file. |
state_exemption (anyOf 2) | null | Alternative | State exemption, as reported by the ingested file. |
stock_options_and_awards_employee_status | JSON | Required within parent | |
stock_options_and_awards_employee_status (anyOf 1) | string | Alternative | Stock Options and Awards Employee Status, as reported by the ingested file. |
stock_options_and_awards_employee_status (anyOf 2) | null | Alternative | Stock Options and Awards Employee Status, as reported by the ingested file. |
stock_options_and_awards_employee_status_effective_date | JSON | Required within parent | |
stock_options_and_awards_employee_status_effective_date (anyOf 1) | string | Alternative | Stock Options and Awards Employee Status (Effective Date), as reported by the ingested file. Format: date |
stock_options_and_awards_employee_status_effective_date (anyOf 2) | null | Alternative | Stock Options and Awards Employee Status (Effective Date), as reported by the ingested file. Format: date |
tax_identifier | JSON | Required within parent | |
tax_identifier (anyOf 1) | string | Alternative | Tax identifier, as reported by the ingested file. |
tax_identifier (anyOf 2) | null | Alternative | Tax identifier, as reported by the ingested file. |
total_exercise_price | JSON | Required within parent | |
total_exercise_price (anyOf 1) | JSON | Alternative | |
total_exercise_price (anyOf 1) (anyOf 1) | number | Alternative | Total exercise price for the grant, as reported by the ingested file. Format: double |
total_exercise_price (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
total_exercise_price (anyOf 2) | null | Alternative | Total exercise price for the grant, as reported by the ingested file. Format: double |
total_fmv | JSON | Required within parent | |
total_fmv (anyOf 1) | JSON | Alternative | |
total_fmv (anyOf 1) (anyOf 1) | number | Alternative | Total fair market value of the grant, as reported by the ingested file. Format: double |
total_fmv (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
total_fmv (anyOf 2) | null | Alternative | Total fair market value of the grant, as reported by the ingested file. Format: double |
updated_at | string | Required within parent | Timestamp this record was last upserted, for incremental sync. Format: date-time |
vesting_schedule | JSON | Required within parent | |
vesting_schedule (anyOf 1) | string | Alternative | Vesting schedule name, as reported by the ingested file. |
vesting_schedule (anyOf 2) | null | Alternative | Vesting schedule name, as reported by the ingested file. |
vesting_start_date | JSON | Required within parent | |
vesting_start_date (anyOf 1) | string | Alternative | Vesting start date, as reported by the ingested file. Format: date |
vesting_start_date (anyOf 2) | null | Alternative | Vesting start date, as reported by the ingested file. Format: date |