Retrieve Benefits for EOR Contract | Deel

{
  "data": [
    {
      "id": "483921",
      "name": "Health Insurance",
      "plan": {
        "name": "Gold Plan"
      },
      "provider": {
        "name": "Global Insurance Co."
      },
      "offer_status": "Offered",
      "enrollment_details": {
        "plan": {
          "name": "Gold Plan"
        },
        "status": "ENROLLED",
        "standard": {
          "monthly_cost": "180.00",
          "employee_monthly_contribution": "130.00"
        },
        "current_cycle": {
          "monthly_cost": "200.00",
          "employee_monthly_contribution": "150.00"
        }
      }
    },
    {
      "id": "483922",
      "name": "Retirement Plan",
      "plan": {
        "name": "Standard Pension"
      },
      "provider": {
        "name": "Pension Trust"
      },
      "offer_status": "Not offered",
      "enrollment_details": {
        "plan": {
          "name": ""
        },
        "status": "AWAITING_ENROLLMENT",
        "standard": {},
        "current_cycle": {}
      }
    }
  ],
  "worker_benefits_link": {
    "url": "https://example.com/session/abc",
    "expires_at": "2026-10-16T10:42:00Z"
  }
}

Returns the worker’s EOR benefits enrolment details. For organisations set up as white-label with Deel, the response also includes a short-lived link to redirect the worker, who doesn’t use the Deel app, to complete enrolment and manage their benefits. Call this endpoint again for a fresh link after it expires.

Token scopes: contracts:read, benefits: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/

Path parameters

contract_idstringRequired

Deel contract ID.

Response

Successfully retrieved the list of EOR contract benefits.

datalist of objectsOptional

worker_benefits_linkobjectOptional

Short-lived link where the worker completes their benefits enrolment and manages their benefits. Only returned for organisations set up as white-label with Deel, whose workers don’t use the Deel app. Redirect the worker to it from your app; call this endpoint again for a new link after expires_at. Don’t store, email or share it.

Errors

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error