Returns all estimation votes for a task, including active votes and previous rounds.
https://api.doboard.com/{account_id}/estimation_get
account_id is the numeric organization identifier.
GET, POST. POST accepts parameters as application/x-www-form-urlencoded.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
session_id |
string | Yes | — | Authenticated session ID. |
task_id |
int | Yes | — | Task whose estimation votes should be returned. |
The session user must belong to the task’s project. Otherwise, the method returns Task Not Found.
GET https://api.doboard.com/42/estimation_get?session_id=YOUR_SESSION_ID&task_id=101
{
"data": {
"estimations": [
{
"vote_id": 301,
"user_id": 12,
"task_id": 101,
"created": "2026-10-16 09:00:00",
"updated": "2026-10-16 09:00:00",
"hours": 7200,
"status": "ACTIVE",
"founder": 1
}
],
"operation_status": "SUCCESS"
}
}
All identifiers and timestamps in examples are illustrative.
| Field | Description |
|---|---|
vote_id |
Vote identifier. |
user_id |
User who submitted the vote. |
task_id |
Task identifier. |
created |
Vote creation timestamp. |
updated |
Vote creation or last estimate-change timestamp. |
hours |
Estimate in seconds. For example, 7200 means two hours. |
status |
ACTIVE, DONE, ARCHIVE or REMOVED. |
founder |
1 identifies the user who started the round; otherwise 0. |
Status meanings:
ACTIVE — vote in the current open round.DONE — vote in a finalized round.ARCHIVE — vote from the preceding finalized round.REMOVED — older retained vote.| HTTP Code | error_no |
Message | Description |
|---|---|---|---|
401 |
401 |
session_id Unknown |
Missing or invalid session. |
200 |
8301 |
task_id is required |
Task ID was not supplied or is empty. |
200 |
8301 |
Task Not Found |
The task does not exist or the user is not a member of its project. |
Both task validation errors use 8301; inspect the message to distinguish them.
estimations: [].updated timestamp.