This API returns a list of projects visible to the current user. It supports filtering by status, project ID, favorites, and pagination. Admin users can access all projects.
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 or token.
This endpoint supports both:
GET https://api.doboard.com/42/project_get?status=ACTIVE&length=25&favorite=1&session_id=abc123xyz
In this example:
42 is the organization/account IDstatus=ACTIVE filters for active projectslength=25 limits the response to 25 itemsfavorite=1 includes only favorited projectssession_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/project_get?status=ACTIVE&length=25&favorite=1&session_id=abc123xyz
Provide either:
session_id – for authenticated userstoken – for 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* | – | Session ID (13–32 alphanumeric characters) |
token |
string |
Yes* | – | Guest access token (used instead of session_id) |
project_id |
int / array |
No | – | One or more project IDs (comma-separated or array) |
status |
string |
No | – | One of: ACTIVE, ARCHIVE, REMOVED, TEMPLATE |
favorite |
boolean |
No | – | 1 = only favorites, 0 = exclude favorites |
start |
int |
No | 0 |
Offset for pagination |
length |
int |
No | 100 |
Limit per page. Allowed: 10, 25, 50, 100 |
* Either session_id or token is required.
{
"data": {
"operation_status": "SUCCESS",
"projects": [
{
"project_id": 12,
"name": "CRM Development",
"description": "Internal CRM system",
"status": "ACTIVE",
"created": "2024-12-01 10:00:00",
"updated": "2025-06-30 12:00:00",
"hours_estimated": 200,
"hours_worked": 150,
"hours_avaible": 50,
"tasks_total": 70,
"tasks_opened": 10,
"tasks_closed": 60,
"auto_close_track": 1,
"tracks_total": 20,
"tracks_opened": 5,
"tracks_closed": 15,
"project_token": "e49c07a93fd8d75dfd133f4ed0d4e2b1",
"project_type": "REGULAR",
"favorite": 1,
"projects_users": [1, 2, 7]
}
],
"records_filtered": 1
}
}
| Field | Type | Description |
|---|---|---|
project_id |
int |
Unique project identifier |
name |
string |
Project name |
description |
string |
Project description |
status |
string |
One of: ACTIVE, ARCHIVE, REMOVED, TEMPLATE |
created |
string |
Creation timestamp (YYYY-MM-DD HH:MM:SS) |
updated |
string |
Last updated timestamp |
hours_estimated |
int | null |
Estimated time in hours |
hours_worked |
int | null |
Worked time in hours |
hours_avaible |
int | null |
Available time in hours |
tasks_total |
int | null |
Total number of tasks |
tasks_opened |
int | null |
Number of open tasks |
tasks_closed |
int | null |
Number of closed tasks |
auto_close_track |
boolean |
Whether auto-closing of tracks is enabled |
tracks_total |
int |
Total number of tracks |
tracks_opened |
int |
Number of open tracks |
tracks_closed |
int |
Number of closed tracks |
project_token |
string | null |
Public token for project access (if any) |
project_type |
string |
Either REGULAR or PUBLIC |
favorite |
int |
1 if the project is marked as favorite by the user, otherwise 0 |
projects_users |
int[] |
List of user IDs associated with the project |
| HTTP Code | error_no |
Message | Description |
|---|---|---|---|
401 |
401 |
Unauthorized |
No session or token provided |
200 |
3401 |
status must be in (...) |
Invalid status value |
200 |
3402 |
Access is denied |
User has no access to requested project |
500 |
0 |
Internal API Error |
Internal error |
200 |
7 |
limit reached |
Too many session attempts from same IP |
Admin users see all projects; regular users see only those they're linked to via projects_users.
favorite is calculated dynamically using the favorites table.
Rate-limiting prevents brute-force attempts on session validation.
This endpoint supports pagination and combined filters (e.g., project_id + status).