List organization tasks | Deel

curl -G https://api.letsdeel.com/rest/organizations/tasks \
     -H "Authorization: Bearer <token>" \
     -d category=OTHER_TASKS \
     -d cursor=eyJvZmZzZXQiOjIwLCJsaW1pdCI6MjB9 \
     -d external_id=ext-ref-123 \
     -d limit=20 \
     --data-urlencode "search=Submit timesheet" \
     -d statuses=PENDING

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "status": "PENDING",
      "category": "OTHER_TASKS",
      "due_date": "2025-03-15T23:59:59.000Z",
      "assignees": [
        {
          "id": "2d6I9IfaKbQsJlevzy1LM",
          "email": "jane.doe@example.com",
          "last_name": "Doe",
          "first_name": "Jane"
        }
      ],
      "created_at": "2025-02-01T10:00:00.000Z",
      "expired_at": null,
      "description": "Please submit your timesheet for the current period.",
      "external_id": null,
      "resolved_at": null,
      "display_name": "Submit your timesheet"
    }
  ],
  "has_more": false,
  "next_cursor": "eyJvZmZzZXQiOjIwLCJsaW1pdCI6MjB9",
  "total_count": 42
}

Returns a paginated list of all tasks for the current organization, not limited to those assigned to the caller; intended for callers with the organization.manage permission. Supports both offset/limit and cursor-based pagination, which are mutually exclusive — do not supply cursor together with an offset parameter.

Token scopes: tasks: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

statuseslist of enumsOptionalDefaults to ["PENDING"]

Filter by task statuses.

Allowed values:

categoryenumOptional

Filter by task category.

searchstringOptional

Search string for task display name or description.

external_idstringOptional

Filter by external ID (for tasks created with an external reference).

cursorstringOptional

Opaque cursor for cursor-based pagination. When provided, use with limit only (do not use offset).

limitintegerOptional1-100Defaults to 20

Maximum number of records to return (1-100).

Response

Successful response. Returns tasks for the organization

datalist of objects

List of task objects for the organization.

has_moreboolean

Flag to highlight if there are more items to be fetched.

next_cursorstring or null

Cursor to request the next page; null if there are no more pages.

total_countinteger>=0

Total number of tasks matching the filter.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error