Skip to navigation
EndpointsIt Seats

List IT seats

Lists the seats of your organization’s IT-seat subscription so you can audit which worker holds which seat, and reconcile seat usage. Cursor-paginated and filterable by seat status and by the HRIS profile holding the seat. A seat with no worker reports a null assigned_hris_profile. Only organizations on a per-seat plan can use this endpoint.

Token scopes: it-seats: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.letsdeel.com/rest/v2/contracts' \
  -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

OR
AuthorizationBearer

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Query parameters

cursorstringOptional
Indicates where the next page of results starts, as returned in a paginated list response
limitintegerOptional1-100Defaults to 20
Return a page of results with given number of records
statuslist of enumsOptional

Filter seats by their status — repeat the key for OR semantics. Omit to include seats of any status.

Allowed values:
hris_profile_idlist of stringsOptional

Filter seats by the HRIS profile holding them — repeat the key for OR semantics. Ids not found in your organization match nothing. Omit to include seats of any worker.

Response

OK
datalist of objects
has_moreboolean
Whether there are more results available
next_cursorstring or null
Cursor to the next page
total_countlong
Total number of records

Errors

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