Skip to navigation

List products in the catalog

Beta

Browse the Deel IT catalog to see which devices are available for purchase or rent before creating an order, filtered by country and other criteria. Returns product metadata only — no pricing, taxes, fees, or contract settings.

Token scopes: it-products:read

Beta: this version requires the X-Beta: true request header and its contract may change before it is promoted to stable. It is scheduled to become stable on 2026-12-17.

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/

Headers

X-BetaenumRequiredDefaults to true

Opts in to the beta version of this endpoint. Must be true.

Allowed values:

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
countrystringOptional

ISO 3166 alpha-2 country code. Restricts results to products whose variants ship to this country.

stock_conditionenumOptional
Filter by stock condition. Omit to include products of any stock condition.
Allowed values:
acquisition_typeslist of enumsOptional

Restrict results to products offering at least one of these acquisition types (RENTAL, PURCHASE, REUSE). REUSE represents BYOD (customer-owned) stock. Omit to include all acquisition types the organization is entitled to.

Allowed values:
searchstringOptional

Return products whose name or brand contains this text. Case-insensitive, and partial words match, so ‘book’ finds ‘MacBook Pro’. Only the name and brand are searched — not the description or hardware specification. Use brands for an exact manufacturer match.

categoryenumOptional
Filter by product category
operating_systemslist of enumsOptional

Filter by operating system — repeat for OR semantics

keyboard_layoutslist of enumsOptional

Filter by keyboard layout — repeat for OR semantics

brandslist of stringsOptional

Filter by manufacturer — exact and case-insensitive, repeat for OR semantics. Unlike search it does not substring-match.

it_policy_idslist of stringsOptional
Restrict results to products approved by any of these IT policies, to see what workers on those policies can order. Repeat for OR semantics. A policy id your organization does not own matches nothing.
is_marketplacebooleanOptional
Filter by marketplace sourcing. Organizations without marketplace access never see marketplace products, and the filter is ignored for them rather than emptying the catalog.

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
500
Internal Server Error