List payroll groups for a legal entity | Deel

curl -G https://api.letsdeel.com/rest/payroll-groups \
     -H "Authorization: Bearer <token>" \
     -d calendarYear=2026 \
     -d includePayrollCalendar=true \
     -d legalEntityId=3fe30c6d-e07a-471e-ac9d-9b5e03a78925 \
     -d "pagination[limit]=10"

{
  "data": [
    {
      "id": "019ed109-aff0-777c-a0bc-b24e9f5eb6df",
      "name": "Monthly Payroll",
      "calendars": [
        {
          "id": "019ed109-b234-777c-a0bd-54060d27425a",
          "values": {
            "CYCLE_APPROVAL": {
              "value": "2026-01-22T00:00:00.000Z"
            },
            "CYCLE_PUBLISHING": {
              "value": "2026-01-20T00:00:00.000Z"
            },
            "CYCLE_SUBMISSION": {
              "value": "2026-01-16T00:00:00.000Z"
            },
            "END": {
              "value": "2026-01-31T00:00:00.000Z"
            },
            "FINAL_BATCH_REPORTS": {
              "value": "2026-02-03T00:00:00.000Z"
            },
            "FUNDING_PAYMENT_RECEIPT": {
              "value": "2026-01-27T00:00:00.000Z"
            },
            "INVOICE_PUBLISHING": {
              "value": "2026-01-21T00:00:00.000Z"
            },
            "LATE_STARTERS_CUTOFF": {
              "value": "2026-01-15T00:00:00.000Z"
            },
            "PAYMENT_RELEASE": {
              "value": "2026-01-28T00:00:00.000Z"
            },
            "PAYROLL_FUNDING": {
              "value": "2026-01-23T00:00:00.000Z"
            },
            "PAYSLIPS_PUBLISHING": {
              "value": "2026-01-29T00:00:00.000Z"
            },
            "SALARY_PAY": {
              "value": "2026-01-30T00:00:00.000Z"
            },
            "SOFT_G2N_UPLOAD": {
              "value": "2026-01-19T00:00:00.000Z"
            },
            "START": {
              "value": "2026-01-01T00:00:00.000Z"
            },
            "TIME_SHEETS_CUT_OFF": {
              "value": "2026-01-15T00:00:00.000Z"
            }
          },
          "calendar_type": "REGULAR"
        }
      ],
      "is_active": true,
      "regular_cycle_cadence": "MONTHLY"
    }
  ],
  "pagination": {
    "limit": 10,
    "hasMore": false,
    "nextCursor": "Mg=="
  }
}

Lists the active payroll groups of a legal entity, with the REGULAR payroll calendars of each group that start in the chosen year (the current year by default). Use it to find the payroll groups of a legal entity and their calendars for a given year; leave the calendars out when you only need the groups.

Token scopes: global-payroll: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

legalEntityIdstringRequiredformat: "uuid"

Public UUID of the legal entity whose payroll groups to retrieve.

calendarYearintegerOptional2020-2035

Calendar year to filter payroll cycles by. Defaults to the current year.

includePayrollCalendarbooleanOptionalDefaults to true

Whether to include REGULAR payroll calendars for each group. Defaults to true. Set to false to skip calendar fetching for a faster response.

paginationobjectOptionalDefaults to {"limit":10}

Cursor-based pagination parameters. limit: max items per page (1-15, default 10). cursor: opaque string from the previous response’s pagination.nextCursor field.

Response

datalist of objects

paginationobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error