Get a task list by id

GET /v1/lists/{listId}

Returns a single task list. The API key’s owner must be a member of the list. Unlike List task lists, this endpoint also returns archived lists the owner belongs to.

Request

Path parameters

Name	Type	Required	Description
listId	string	yes	Numeric ID of the list.

No request body.

Response

200 OK:

Field	Type	Description
id	number	Numeric ID of the list.
name	string	Display name of the list.
color	string	Color tag of the list.
isArchived	boolean	true if archived.
createdAt	string	ISO 8601 timestamp the list was created.
updatedAt	string	ISO 8601 timestamp of the last update.

Example response

{
  "id": 27,
  "name": "Q3 launch",
  "color": "Blue",
  "isArchived": false,
  "createdAt": "2026-04-12T09:18:33.000Z",
  "updatedAt": "2026-05-08T11:02:08.000Z"
}

Errors

Status	Body	When
400	{ "error": "listId must be a number." }	listId path parameter is not numeric.
403	{ "error": "You do not have access to this list." }	The API key’s owner is not a member of the list.
404	{ "error": "List <id> not found." }	No list with that ID exists in the bound team.