Skip to main content
Planview Customer Success Center

Get a list of cards

GET /io/card/

Get a list of cards.

See also: POST /io/card/list for requests using a JSON body to define filters.

Query Params

Param Type Usage Default
offset integer Set the "start row" number of the first card to be returned 0
limit integer Set the number of cards to be returned 200
select enumeration Only return
cards
taskCards
both
cards
board string Filter to the specified board
lanes string Filter to the specified comma separated lane ids
cards string Filter to the specified comma separated card ids
search string Full text search on card title and external card id
customId string Filter using external card id
type string Filter using the card type id
custom_icon string Filter using custom icon id
lane_class_types string Only return cards in lane class types specified in a csv list. Options are
backlog
active
archive.
since datetime Only return cards updated after this ISO8601 date
deleted boolean Return the card ids for deleted cards
only string Return only the fields specified in a csv list
omit string Return all fields except the ones specified in a csv list
sort enumeration Sort results by
activity
rank
title
Defaults to rank if there is a search param, otherwise activity.
include string Include additional data. Currently customFields is the only supported value. Value is a csv list

Example Request

Get cards across all boards

curl -X GET \
  https://myaccount.leankit.com/io/card \
  -H 'Authorization: Basic base64encodedauthhere'

Get cards for a specific board

curl -X GET \
  https://myaccount.leankit.com/io/card?board=943188457 \
  -H 'Authorization: Basic base64encodedauthhere'

Get cards for a set of lanes

curl -X GET \
  https://myaccount.leankit.com/io/card?lanes=943188474,943188479 \
  -H 'Authorization: Basic base64encodedauthhere'

Get cards and task cards with the word "three" in the title or external card id field

curl -X GET \
  https://myaccount.leankit.com/io/card?search=three&select=both \
  -H 'Authorization: Basic base64encodedauthhere'

Get cards with the specified card type and custom icon in active or backlog lanes

curl -X GET \
  https://myaccount.leankit.com/io/card?custom_icon=943188468&type=943188463&lane_class_types=active,backlog \
  -H 'Authorization: Basic base64encodedauthhere'

Get the id and title of cards updated since 2019-12-05T21:52:12Z sorted by title

curl -X GET \
  https://myaccount.leankit.com/io/card?since=2019-12-05T21:52:12Z&only=title,id&sort=title \
  -H 'Authorization: Basic base64encodedauthhere'

Get specific cards by id

curl -X GET \
  https://myaccount.leankit.com/io/card?cards=123456,43212,987656 \
  -H 'Authorization: Basic base64encodedauthhere'

Example Successful Response

200 Success

{
    "cards": [
        {
            "assignedUsers": [
                {
                    "id": "478440842",
                    "fullName": "First Last",
                    "emailAddress": "user@leankit.com",
                    "avatar": "https://myaccount.leankit.com/avatar/Show/478440842?s=25"
                }
            ],
            "id": "943206946",
            "index": 1,
            "version": "26",
            "title": "Card Three",
            "description": "<p>The card three description</p>",
            "priority": "high",
            "size": 2,
            "plannedStart": "2019-12-20",
            "plannedFinish": "2019-12-23",
            "actualFinish": "2019-12-05T21:52:12Z",
            "actualStart": "2019-12-05T21:52:10Z",
            "createdOn": "2019-12-03T23:27:44Z",
            "archivedOn": null,
            "updatedOn": "2019-12-05T21:52:12Z",
            "movedOn": "2019-12-05T21:52:12Z",
            "tags": [
                "tagone",
                "tagtwo"
            ],
            "containingCardId": null,
            "color": "#B8CFDF",
            "iconPath": null,
            "customIconLabel": "Class of Service",
            "customIcon": {
                "id": "943188468",
                "title": "Regulatory",
                "cardColor": "#FFFFFF",
                "iconColor": "49bbd6",
                "iconName": "lk_icons_final_05-11",
                "iconPath": "https://myaccount.leankit.com/customicons/24/49bbd6/lk_icons_final_05-11.png"
            },
            "blockedStatus": {
                "isBlocked": true,
                "reason": "Blocked card reason",
                "date": "2019-12-04T20:38:33Z"
            },
            "board": {
                "id": "943188457",
                "title": "Example board",
                "version": "103",
                "isArchived": false
            },
            "customId": {
                "value": "The card header text",
                "prefix": null,
                "url": null
            },
            "externalLinks": [
                {
                    "label": "Link Title",
                    "url": "https://www.leankit.com"
                }
            ],
            "lane": {
                "cardLimit": 0,
                "description": null,
                "id": "943188473",
                "index": 3,
                "laneClassType": "active",
                "laneType": "completed",
                "orientation": "vertical",
                "title": "Recently Finished",
                "taskBoard": null,
                "cardStatus": "finished"
            },
            "type": {
                "id": "943188463",
                "title": "New Feature",
                "cardColor": "#B8CFDF"
            },
            "taskBoardStats": {
                "totalCount": 2,
                "completedCount": 1,
                "totalSize": 2,
                "completedSize": 1
            },
            "planningIncrements": [
              {
                "id": "350",
                "label": "PI-3"
              },
              {
                "id": "375",
                "label": "PI-4"
              }
            ],
            "customFields": [
                {
                    "id": "5355212",
                    "value": "abc"
                },
                {
                    "id": "5355213",
                    "value": "123"
                }
            ]
        },
        {
            "assignedUsers": [],
            "id": "944509659",
            "index": 1,
            "version": "3",
            "title": "2",
            "description": null,
            "priority": "normal",
            "size": 0,
            "plannedStart": null,
            "plannedFinish": null,
            "actualFinish": null,
            "actualStart": "2019-12-05T15:48:02Z",
            "createdOn": "2019-12-05T15:48:02Z",
            "archivedOn": null,
            "updatedOn": "2019-12-05T17:39:52Z",
            "movedOn": "2019-12-05T15:48:02Z",
            "tags": [],
            "containingCardId": null,
            "color": "#FFFFFF",
            "iconPath": null,
            "customIconLabel": "Class of Service",
            "customIcon": null,
            "blockedStatus": {
                "isBlocked": false,
                "reason": null,
                "date": null
            },
            "board": {
                "id": "943188457",
                "title": "Example board",
                "version": "103",
                "isArchived": false
            },
            "customId": {
                "value": null,
                "prefix": null,
                "url": null
            },
            "externalLinks": [],
            "lane": {
                "cardLimit": 0,
                "description": null,
                "id": "943188472",
                "index": 1,
                "laneClassType": "active",
                "laneType": "inProcess",
                "orientation": "vertical",
                "title": "Doing Now",
                "taskBoard": null,
                "cardStatus": "started"
            },
            "type": {
                "id": "943188459",
                "title": "Other Work",
                "cardColor": "#FFFFFF"
            },
            "taskBoardStats": null,
            "planningIncrements": [],
            "customFields": []
        }
    ],
    "pageMeta": {
        "totalRecords": 668,
        "offset": 0,
        "limit": 2,
        "startRow": 1,
        "endRow": 2
    },
    "inaccessibleCards": [
      {
        "id": "1014559398",
        "isDeleted": true,
        "hasAccess": true
      }
    ]
}

Note:
"inaccessibleCards" is included only when requesting specific cards by id using the `cards` querystring parameter.
"customFields" are included only when requesting with the `include` parameter.

Status Code Error Message Reason
422 Unprocessable Entity Invalid request: Failed "enum" criteria (pointer: #/select) One of the query parameters doesn't match a valid value. e.g. select=taskcard is not valid but select=taskCards is valid



Updated 2024-03-11 @ 13:03 PM