List payroll groups for a legal entity | Deel

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

{
  "data": [
    {
      "id": "019ed109-aff0-777c-a0bc-b24e9f5eb6df",
      "name": "Monthly Payroll",
      "calendars": [
        {
          "id": "019ed109-b234-777c-a0bd-54060d27425a",
          "values": {
            "START": {
              "value": "2026-01-01T00:00:00.000Z"
            },
            "SALARY_PAY": {
              "value": "2026-01-31T00:00:00.000Z"
            }
          },
          "calendar_type": "REGULAR"
        }
      ],
      "is_active": true,
      "regular_cycle_cadence": "MONTHLY"
    }
  ],
  "pagination": {
    "limit": 10,
    "hasMore": false,
    "nextCursor": "Mg=="
  }
}

Returns payroll groups and their associated REGULAR calendars for the specified legal entity. Defaults to the current year; pass calendarYear to retrieve a specific year.

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.deel.training/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.deel.training/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

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.

paginationobjectOptional

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

$	curl -X GET 'https://api.deel.training/rest/v2/contracts' \
>	-H 'Authorization: Bearer YOUR-TOKEN-HERE'