List organization tasks | Deel

Returns a paginated list of tasks for the current organization. Intended for client users with organization.manage permission (Example: org admins). Use this to see all tasks for the organization, not only those assigned to the caller. Supports filtering by status, category, search, and external ID, and either offset/limit or cursor-based pagination. 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.

1 curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
2   -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/

Query parameters

statuseslist of enumsOptional

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

1	curl -G https://api.letsdeel.com/rest/v2/organizations/tasks \
2	-H "Authorization: Bearer <token>" \
3	-d statuses=PENDING \
4	-d category=PAYROLL \
5	--data-urlencode "search=Submit timesheet" \
6	-d external_id=ext-ref-123 \
7	-d cursor=eyJvZmZzZXQiOjIwLCJsaW1pdCI6MjB9 \
8	-d limit=20

1	{
2	"data": [
3	{
4	"id": "550e8400-e29b-41d4-a716-446655440000",
5	"status": "PENDING",
6	"category": "TIME_SHEET_SUBMISSIONS",
7	"due_date": "2025-03-15T23:59:59.000Z",
8	"assignees": [
9	{
10	"id": "2d6I9IfaKbQsJlevzy1LM",
11	"email": "jane.doe@example.com",
12	"last_name": "Doe",
13	"first_name": "Jane"
14	}
15	],
16	"created_at": "2025-02-01T10:00:00.000Z",
17	"description": "Please submit your timesheet for the current period.",
18	"display_name": "Submit your timesheet"
19	}
20	],
21	"has_more": false,
22	"next_cursor": "eyJvZmZzZXQiOjIwLCJsaW1pdCI6MjB9",
23	"total_count": 42
24	}

1	curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
2	-H 'Authorization: Bearer YOUR-TOKEN-HERE'