This API returns a list of tasks with filtering, sorting, and pagination. Includes label/group info, project & track names, comments counters, and optional Spotfix metadata.
The number in the URL path (/1/) is the organization identifier — referred to as account_id.
This value must match the account associated with the provided session_id, project_token or token.
This endpoint supports both:
GET https://api.doboard.com/42/task_get?project_id=7&status=ACTIVE&length=25&session_id=abc123xyz
In this example:
42 is the organization/account IDproject_id=7 returns tasks from project #7status=ACTIVE filters for active projectslength=25 limits the response to 25 itemssession_id=abc123xyz is used for authenticationIf the account ID in the URL does not match the account tied to the session, the request will be rejected.
Required
GET https://api.doboard.com/42/task_get?project_id=7&status=ACTIVE&length=25&session_id=abc123xyz
Provide either:
session_id – for authenticated userstoken – for public task guest accessproject_token – for public project guest accessApplies rate-limiting: max 50 failed attempts per IP per 10 minutes
Supports guest users by returning guest context with user_type = GUEST
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
session_id |
string |
Yes* | – | Authenticated user session ID. |
token |
string |
No* | – | Guest/public access token (if public access is enabled). |
project_token |
string |
No* | – | Guest/public access token (if public access is enabled). |
task_id |
int | array |
No | – | One task ID or multiple (comma-separated or array). |
project_id |
int |
No | – | Filter by project. |
user_id |
int |
No | – | Filter by assigned user. |
track_id |
int | array |
No | – | Filter by linked track\board. One Track ID or multiple (comma-separated or array). |
label_id |
int |
No | – | Filter by label. |
name |
string |
No | – | Substring match on task name (trimmed, max 256 chars). |
status |
string | array |
No | – | Task status filter: ACTIVE, DONE, REMOVED. One Status or multiple (comma-separated or array). |
task_type |
string |
No | – | Task type filter: REGULAR, LINK, LINK_SYMBOLIC, PUBLIC. |
project_status |
string |
No | – | Project status filter: ACTIVE, ARCHIVE, REMOVED. |
due_date_begin |
string |
No | – | Lower bound for due date; format Y-m-d H:i:s. |
due_date_end |
string |
No | – | Upper bound for due date; format Y-m-d H:i:s. |
order_column |
string |
No | task_id |
Sort column. One of: task_id, task_order_id, grant_order_id, due_date. |
order_dir |
string |
No | DESC |
Sort direction: ASC or DESC. |
start |
int |
No | 0 |
Offset for pagination. |
length |
int |
No | 1000 |
Page size; allowed values 10,15,25,50,100,1000. |
* Either session_id or project_token or token is required.
{
"data": {
"operation_status": "SUCCESS",
"tasks": [
{
"task_id": 101,
"created": "2025-08-31 10:15:00",
"updated": "2025-09-02 16:22:00",
"track_id": 12,
"project_id": 7,
"due_date": "2025-09-10 00:00:00",
"start_date": "2025-09-01 00:00:00",
"name": "Fix login bug",
"user_id": 5,
"status": "ACTIVE",
"task_order_id": 0,
"grant_order_id": null,
"hours_estimated": 8,
"hours_worked": 3,
"task_type": "REGULAR",
"regular_task_id": null,
"attachments_count": 2,
"token": null,
"creator_user_id": 1,
"label_ids": [3, 8, 12],
"label_group_ids": [5, 6],
"active_label_ids": [3, 12],
"project_name": "Web Platform",
"track_name": "Sprint 42",
"comments_count": 4,
"comments_viewers": [1, 2, 7],
"site_id": null,
"page_id": null,
"HTML": null,
"meta": null,
"related_tasks": [
{
"task_id": 202,
"name": "Implement new OAuth flow",
"status": "ACTIVE",
"relation_type": "MANUAL",
"updated": "2025-09-02 15:40:00"
}
],
"links": [301, 302]
}
],
"records_filtered": 1
}
}
Each object inside data.tasks contains the following fields:
| Field | Type | Description |
|---|---|---|
task_id |
int |
Unique task identifier. |
created |
datetime |
Date and time when the task was created. |
updated |
datetime |
Date and time when the task was last updated. |
track_id |
int |
ID of the track the task belongs to (nullable). |
project_id |
int |
ID of the project the task belongs to (nullable). |
due_date |
datetime |
Due date of the task (nullable). |
start_date |
datetime |
Start date of the task (nullable). |
name |
string(256) |
Task title. |
user_id |
int |
ID of the assigned user (nullable). |
status |
enum |
Task status: ACTIVE, DONE, REMOVED. |
task_order_id |
int |
Sort order identifier inside the project. |
grant_order_id |
int |
Additional order field for grants/linked tasks (nullable). |
hours_estimated |
int |
Estimated hours for the task (nullable). |
hours_worked |
int |
Actual worked hours (nullable). |
task_type |
enum |
Task type: REGULAR, LINK, LINK_SYMBOLIC, PUBLIC. |
regular_task_id |
int |
ID of the regular/original task if this task is a LINK or LINK_SYMBOLIC. |
attachments_count |
int |
Number of attachments linked to the task. |
token |
string |
Task token (nullable). If this task is a PUBLIC. |
creator_user_id |
int |
ID of the user who created the task (nullable). |
label_ids |
array |
List of label IDs attached to the task. |
label_group_ids |
array |
List of label group IDs attached to the task. |
active_label_ids |
array |
List of currently active label IDs in label group. |
project_name |
string |
Project name (from projects). |
track_name |
string |
Track name (from tracks). |
comments_count |
int |
Number of active comments linked to the task. |
comments_viewers |
array |
List of user IDs who viewed the task’s comments. |
site_id |
int |
Spotfix: linked site ID (nullable). |
page_id |
int |
Spotfix: linked page ID (nullable). |
HTML |
string |
Spotfix: HTML content of the element (nullable). |
meta |
string |
Spotfix: serialized metadata (nullable). |
| HTTP Code | error_no |
Message | Description |
|---|---|---|---|
401 |
401 |
Unauthorized |
No session or token provided |
200 |
4201 |
project_status must be in ('ACTIVE','ARCHIVE','REMOVED') |
Invalid project_status value. |
200 |
4202 |
task_type must be in ('REGULAR','LINK','LINK_SYMBOLIC','PUBLIC') |
Invalid task_type value. |
200 |
4203 |
due_date_begin is wrong format, expected format: Y-m-d H:i:s |
due_date_begin has an invalid datetime format. |
200 |
4204 |
due_date_end is wrong format, expected format: Y-m-d H:i:s |
due_date_end has an invalid datetime format. |
200 |
4205 |
Access is denied |
The user does not have permission to view the requested tasks/project. |
500 |
0 |
Internal API Error |
Internal error |
200 |
7 |
limit reached |
Too many session attempts from same IP |
Label/linked task logic resolves LINK/LINK_SYMBOLIC to the underlying regular task where appropriate.
Rate-limiting prevents brute-force attempts on session validation.
This endpoint supports pagination and combined filters (e.g., project_id + status).
Special case: if only one task is returned, the response includes two extra fields:
related_tasks — array of objects (up to 100) with fields:
task_id — ID of the related taskname — task namestatus — task statusrelation_type — type of relationupdated — last update timestamplinks — array of task IDs (up to 100) where this task is used as regular_task_id