EndpointsEquity Tokens

List equity grants with tax events

Retrieves the equity grants for an organization, each including its vesting events and associated tax events. Requires the `equities.view` permission at the organization level. Tokens whose profile holds `equities.view` only within a specific team are rejected with `403 Access denied`. **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 curl -X GET 'https://api.deel.training/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication)
OR
AuthorizationBearer
Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Query parameters

limitintegerOptional1-100Defaults to 100
Maximum number of grants to return
offsetintegerOptional>=0Defaults to 0
Number of grants to skip before starting to return results
searchstringOptional<=255 characters

Free-text search across grant/worker name and email

Response

A paginated list of equity grants, each including its vesting events and associated tax events.
datalist of objectsOptional
limitintegerOptional
The limit applied to this page of results
totalintegerOptional

The total number of grants matching the query, independent of limit/offset

offsetintegerOptional
The offset applied to this page of results

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error