Retrieve an agreement

GET

/it/agreements/:agreement_id

GET

/rest/it/agreements/:agreement_id

curl https://api.letsdeel.com/rest/it/agreements/3b1a0000-0000-0000-0000-000000000000 \
     -H "Authorization: Bearer <token>"

{
  "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"
    }
  }
}

Retrieves one rental agreement, including the reuse context needed to reassign it: actions.reuse.details.reusable_variants lists the device variants the next holder can receive. Call this before POST /rest/it/agreements/{agreement_id}/reassign to pick a variant_id.

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/

Path parameters

agreement_idstringRequiredformat: "uuid"

Unique identifier of the agreement

Response

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error