List agreements

GET

/it/agreements

GET

/rest/it/agreements

curl -G https://api.letsdeel.com/rest/it/agreements \
     -H "Authorization: Bearer <token>" \
     -d cursor=d3m0d3m0d3m0d3m0d3m0d3m0d3m0d3m0d3m0d3m \
     -d limit=10 \
     -d status=ACTIVE \
     -d type=RENTAL \
     -d store_and_reuse_status=READY \
     -d hris_profile_id=6ad9f0f0-6e2a-4f9a-a3f8-2a9f5f2d6b71

{
  "data": [
    {
      "id": "3b1a0000-0000-0000-0000-000000000000",
      "type": "RENTAL",
      "status": "ACTIVE",
      "actions": {
        "reuse": {
          "details": {
            "reassignable_in": [
              "GB",
              "IE",
              "FR",
              "DE"
            ],
            "reusable_variants": [
              {
                "id": "2f4e7ab1-9d3c-4b1f-9e34-6dfb0d6a12ab",
                "sku": "MBP16-M3P-SPACE-UK",
                "size": "16-inch",
                "image": {
                  "id": "b1c3d5e7-8a9b-4c2d-9e0f-1a2b3c4d5e6f",
                  "url": "https://cdn.deel.com/products/mbp16-space-black.png"
                },
                "style": "Space Black",
                "public_id": "VAR-2f4e",
                "keyboard_layout": "UK_ENGLISH_QWERTY",
                "operating_system": "MACOS",
                "available_countries": [
                  "AD"
                ],
                "allowed_rental_terms": [
                  "MONTH_12"
                ],
                "allowed_acquisition_types": [
                  "PURCHASE"
                ]
              }
            ]
          },
          "is_enabled": true,
          "disabled_reason": "CONTRACT_IS_NOT_REUSE_ENABLED"
        }
      },
      "product": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "MacBook Pro",
        "brand": "Apple",
        "category": "LAPTOP"
      },
      "end_date": "2026-11-15",
      "public_id": "CTR-3b1a",
      "created_at": "2024-11-01T09:00:00Z",
      "start_date": "2024-11-15",
      "updated_at": "2026-07-14T10:00:00Z",
      "variant_id": "2f4e7ab1-9d3c-4b1f-9e34-6dfb0d6a12ab",
      "store_and_reuse": {
        "status": "READY"
      },
      "billing_entity_id": "550e8400-e29b-41d4-a716-446655440000",
      "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 rental agreements your organization holds with Deel, each with its current store-and-reuse state. Call this to find agreements whose device is free to hand to a different worker — an agreement in store_and_reuse.status = READY can be reassigned via POST /rest/it/agreements/{agreement_id}/reassign. Results are cursor-paginated.

Token scopes: it-agreements:read

Lists the rental agreements your organization holds with Deel, each with its current store-and-reuse state. Call this to find agreements whose device is free to hand to a different worker — an agreement in `store_and_reuse.status = READY` can be reassigned via `POST /rest/it/agreements/{agreement_id}/reassign`. Results are cursor-paginated. **Token scopes**: `it-agreements: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

## 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.letsdeel.com/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

statusenumOptional

Filter agreements by status. Repeat the key to filter on multiple values.

Allowed values:

typeenumOptional

Filter agreements by type. Repeat the key to filter on multiple values.

Allowed values:

store_and_reuse_statusenumOptional

Filter rentals by store-and-reuse status. Repeat the key to filter on multiple values. NOT_STARTED is not accepted (omit the filter to include agreements without store-and-reuse).

Allowed values:

hris_profile_idstringOptionalformat: "uuid"

Filter by the HRIS profile id currently holding the agreement.

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