List equity participants

GET

/equity-participants

GET

/rest/equity-participants

$ curl -G https://api.letsdeel.com/rest/equity-participants \
>      -H "Authorization: Bearer <token>" \
>      -d limit=50 \
>      -d cursor=eyJzb3J0VmFsdWUiOiI5MDAxIiwiaWQiOiJhMWIyYzNkNC1lNWY2LTc4OTAtYWJjZC1lZjEyMzQ1Njc4OTAifQ \
>      -d employee_number=9001

1 {
2   "data": [
3     {
4       "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
5       "ssn": "123-45-6789",
6       "email": "jane.doe@personal.example",
7       "row_hash": "9f2c1a7e4b6d8f0a2c4e6b8d0f2a4c6e8b0d2f4a6c8e0b2d4f6a8c0e2b4d6f8a",
8       "full_name": "Jane Q Doe",
9       "hire_date": "2021-09-13",
10       "created_at": "2026-08-13T09:01:02.000Z",
11       "updated_at": "2026-08-13T09:01:02.000Z",
12       "cost_center": "R&D",
13       "company_email": "jane.doe@example.com",
14       "pre_clearance": "Not Required",
15       "source_file_id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
16       "employee_number": "9001",
17       "hris_profile_id": 4821,
18       "home_address_city": "Austin",
19       "organization_name": "Deel Inc.",
20       "current_employment": "Full Time",
21       "account_holder_type": "Employee",
22       "home_address_line_1": "1 Example Street",
23       "home_address_line_2": "Apartment 4",
24       "home_address_country": "United States",
25       "last_seen_dataset_id": "c3d4e5f6-a7b8-9012-cdef-345678901234",
26       "account_activation_date": "2024-12-06T14:04:00.000Z",
27       "alternate_employee_number": "A-9001",
28       "cost_center_effective_date": "2024-01-01",
29       "home_address_state_province": "TX",
30       "home_address_zip_postal_code": "78701",
31       "current_employment_description": "Transferred from the UK entity",
32       "company_provided_personal_email": "jane.doe@personal.example",
33       "current_employment_effective_date": "2024-03-01",
34       "stock_options_and_awards_employee_status": "Active",
35       "stock_options_and_awards_employee_status_effective_date": "2024-03-01"
36     }
37   ],
38   "has_more": false,
39   "next_cursor": "eyJzb3J0VmFsdWUiOiI5MDAxIiwiaWQiOiJhMWIyYzNkNC1lNWY2LTc4OTAtYWJjZC1lZjEyMzQ1Njc4OTAifQ=="
40 }

Retrieves the people who hold equity in an organization, as ingested from Shareworks, in ascending employee_number order. Use it to reconcile equity participants against HRIS records, or to feed worker identity and residence data into equity tax calculations. Records carry direct identifiers, including a full Social Security Number where the source reports one. Requires the equities.view permission at the organization level.

Token scopes: equities:read

Retrieves the people who hold equity in an organization, as ingested from Shareworks, in ascending employee_number order. Use it to reconcile equity participants against HRIS records, or to feed worker identity and residence data into equity tax calculations. Records carry direct identifiers, including a full Social Security Number where the source reports one. 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.

Response

List equity participants returned successfully.

datalist of objects

Page of equity participant records, one per Shareworks employee number.

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'