List IT assets | Deel | Documentation

curl -G https://api.letsdeel.com/rest/it/assets \
     -H "Authorization: Bearer <token>" \
     -d category=DESK \
     -d cursor=d3m0d3m0d3m0d3m0d3m0d3m0d3m0d3m0d3m0d3m \
     -d hris_profile_id=123e4567-e89b-12d3-a456-426614174000 \
     -d keyboard_layouts=SWEDISH_QWERTY \
     -d limit=10 \
     -d location=AT_WAREHOUSE \
     -d operating_systems=MACOS \
     -d search=MacBook \
     -d status=ARCHIVED

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "grade": "A",
      "status": "ACTIVE",
      "product": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "MacBook Pro",
        "brand": "Apple",
        "category": "LAPTOP"
      },
      "location": "WITH_USER",
      "ownership": {
        "name": "Deel",
        "type": "DEEL"
      },
      "public_id": "ITM-550E8400",
      "created_at": "2025-08-08T09:49:01.000Z",
      "updated_at": "2025-08-08T09:49:01.000Z",
      "assigned_user": {
        "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"
      },
      "purchase_date": "2025-08-08",
      "serial_number": "SN123456",
      "purchase_value": {
        "amount": "1999.99",
        "currency": "EUR"
      },
      "keyboard_layout": "SWEDISH_QWERTY",
      "operating_system": "MACOS",
      "assigned_warehouse": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "Batcave Warehouse",
        "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"
        },
        "ownership": "DEEL",
        "public_id": "WRH-550E8400",
        "warehouse_type": "DEEL"
      }
    }
  ],
  "has_more": true,
  "next_cursor": "d3m0d3m0d3m0d3m0d3m0d3m0d3m0d3m0d3m0d3m",
  "total_count": 133
}

Lists the IT assets your organization owns or rents, current and historical, with status and assignment metadata. Use it to reconcile Deel’s inventory against your own MDM or CMDB, or to find an asset to reassign. Filter by holder, location, category, status, keyboard layout, or operating system, or search by product name or brand.

Token scopes: it-assets: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

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

hris_profile_idstringOptionalformat: "uuid"

Filter assets by assigned worker with given HRIS Profile ID

locationenumOptional

Filter assets by their location

categoryenumOptional

Filter assets by their product category

statusenumOptional

Filter assets by their status

Allowed values:

keyboard_layoutslist of enumsOptional

Filter assets by keyboard layout, repeat for OR semantics. Assets without a recorded layout never match.

operating_systemslist of enumsOptional

Filter assets by operating system, repeat for OR semantics. Assets without a recorded operating system never match.

searchstringOptional

Return assets whose product name or brand contains this text. Case-insensitive, and partial words match, so ‘macbook pro’ finds ‘Apple MacBook Pro’.

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

500

Internal Server Error