List IT seats

GET

/it/seats

GET

/rest/it/seats

curl -G https://api.letsdeel.com/rest/it/seats \
     -H "Authorization: Bearer <token>" \
     -d cursor=d3m0d3m0d3m0d3m0d3m0d3m0d3m0d3m0d3m0d3m \
     -d limit=20 \
     -d status=ASSIGNED \
     -d hris_profile_id=6ad9f0f0-6e2a-4f9a-a3f8-2a9f5f2d6b71

{
  "data": [
    {
      "id": "3b1a0000-0000-0000-0000-000000000000",
      "status": "ASSIGNED",
      "active_on": "2026-01-20",
      "created_at": "2026-01-15T09:00:00Z",
      "assigned_at": "2026-01-15T09:00:00Z",
      "declined_at": "2026-01-18T14:30:00Z",
      "deactivated_on": "2026-06-30",
      "assigned_hris_profile": {
        "emails": [
          "bruce.wayne@wayne-enterprise.com",
          "batman@gotham.com"
        ],
        "address": {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "city": "Gotham",
          "type": "DELIVERY",
          "line1": "1007 Mountain Drive",
          "line2": "Stately Wayne Manor",
          "state": "New Jersey",
          "country": "US",
          "is_valid": true,
          "post_code": "12345",
          "phone_number": "+1-212-456-7890",
          "date_of_birth": "1997-12-18",
          "tax_id_number": "BAT123456",
          "passport_number": "P123456789",
          "delivery_instructions": "Use the Bat-Signal if urgent"
        },
        "last_name": "Wayne",
        "first_name": "Bruce",
        "hris_profile_id": "550e8400-e29b-41d4-a716-446655440000"
      }
    }
  ],
  "has_more": true,
  "next_cursor": "d3m0d3m0d3m0d3m0d3m0d3m0d3m0d3m0d3m0d3m",
  "total_count": 133
}

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

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.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

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

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