Skip to main content
Planview Customer Success Center

Get cardsIds within a specific increment status category

GET /io/series/:seriesId/increment/:incrementId/status/:category

List the cardIds of cards in the increment that are currently in the increment status category specified by the :category path parameter.

Path Parameters

Name Description Required Schema
seriesId ID of the planning series Yes string
incrementId ID of the increment Yes string
category Status category of cards to retrieve Yes string

Category Values

The category parameter accepts the following values:

  • notStarted - Cards that have not been started yet
  • inProgress - Cards that are currently in progress
  • completed - Cards that are completed
  • committed - Cards that are committed to the increment
  • unplanned - Cards that are in the increment but were not originally planned

Responses

Code Description Schema
200 Successfully retrieved card IDs ExpandStatusCategoryResponse
400 Bad request, invalid parameters Error
404 Series or increment not found Error

ExpandStatusCategoryResponse

Property Type Description
cardIds array[string] List of card IDs in the specified category
blockedCardIds array[string] Subset of cardIds that are currently blocked

Example Request

1curl -X GET \
3  -H 'Authorization: Basic base64encodedauthhere'

Example Successful Response

01200 OK
02{
03    "cardIds": [
04        "2222",
05        "3333"
06    ],
07    "blockedCardIds": [
08        "3333"
09    ]
10}



Updated 2025-04-02 @ 18:04 PM