Returns the list of iterations of a space. Requires the user to have access to the space. The iterations feature must be enabled for the company.
| Name | Type | Reference |
|---|---|---|
| space_uidrequired | string | Space UID |
| Name | Value |
|---|---|
| Authorization | Bearer <token> |
| Content-Type | application/json |
| Name | Type | Constraints | Description |
|---|---|---|---|
| status | string | Filter by iteration status. Comma separated list of: planned, active, closed, removed | |
| with_data | string | Include related data. Comma separated list of: cards. Iterations with the status 'removed' do not contain cards. Starting November 1, 2026, this parameter is not available in the public API and requests containing it return HTTP 400. Retrieve cards separately using GET /spaces/{space_uid}/iterations/{iteration_id}/cards?status=active. | |
| limit | number | Maximum number of iterations to return. Clamped to the range 1-100. Default: 100. | |
| offset | number | Number of iterations to skip from the beginning of the result set. Default: 0. | |
| order | string | Sort order by creation date: asc or desc. Default: asc. |
| Description | Response type | Example |
|---|---|---|
| Success | Array of objects |
| Name | Type | Description |
|---|---|---|
| id | string | Iteration ID (UUID) |
| space_uid | string | UID of the space the iteration belongs to |
| title | string | Iteration title |
| goal | string | null | Iteration goal |
| status | string | Iteration status: planned, active, closed or removed |
| creator_uid | string | UID of the user who created the iteration |
| updater_uid | string | UID of the user who last updated the iteration |
| start_date | string | null | Start date, ISO 8601 format |
| finish_date | string | null | Planned finish date, ISO 8601 format |
| actual_finish_date | string | null | Actual finish date, ISO 8601 format |
| sort_order | number | Sort order of the iteration within the space |
| data | object | null | Cached iteration statistics. Null for planned iterations; active iterations contain committed, and closed iterations also contain velocity, doneCount and totalCount |
| created | string | Creation timestamp |
| updated | string | Last update timestamp |
| cards | array of objects | Iteration card records. Included only when with_data=cards is requested. Cards removed from the iteration are excluded, and iterations with the 'removed' status do not contain cards. Starting November 1, 2026, related cards are not available in the public API list response; retrieve them using GET /spaces/{space_uid}/iterations/{iteration_id}/cards?status=active. |
| Description | Response type | Example |
|---|---|---|
| Invalid token | String |
| Description | Response type | Example |
|---|---|---|
| Feature is not supported by tariff | Object |
| Name | Type | Description |
|---|---|---|
| message | string | Error message |
| Description | Response type | Example |
|---|---|---|
| Forbidden | Response body does not exist |
| Description | Response type | Example |
|---|---|---|
| Space not found | Response body does not exist |
Path Parameters
1 curl --request GET \
2 --url 'https://example.kaiten.ru/api/latest/spaces/{space_uid}/iterations' \
3 --header 'Accept: application/json' \
4 --header 'Content-Type: application/json'
5 Response
ClickTry It!to start a request and see the response here!