List

All tasks created in Wunderlist belong to a list.

Get all Lists a user has permission to

GET a.wunderlist.com/api/v1/lists

Response

Status: 200

json
[
  {
    "id": 83526310,
    "created_at": "2013-08-30T08:29:46.203Z",
    "title": "Read Later",
    "list_type": "list",
    "type": "list",
    "revision": 10
  }
]

Get a specific List

GET a.wunderlist.com/api/v1/lists/:id

Response

Status: 200

json
{
  "id": 83526310,
  "created_at": "2013-08-30T08:29:46.203Z",
  "title": "Read Later",
  "list_type": "list",
  "type": "list",
  "revision": 10
}

Create a list

POST a.wunderlist.com/api/v1/lists

Data

name type notes
title string required. maximum length is 255 characters

Request body example

json
{
  "title": "Hallo"
}

Response

Status: 201

json
{
  "id": 83526310,
  "created_at": "2013-08-30T08:29:46.203Z",
  "title": "Read Later",
  "revision": 1000,
  "type": "list"
}

Update a list by overwriting properties

PATCH a.wunderlist.com/api/v1/lists/:id

Data

name type notes
revision integer required
title string maximum length is 255 characters

Request body example

json
{
  "revision": 1000,
  "title": "Hallo"
}

Response

Status 200

json
{
  "id": 409233670,
  "revision": 1001,
  "title": "Hello",
  "type": "list"
}

Delete a list permanently

DELETE a.wunderlist.com/api/v1/lists/:id

Params

name type notes
revision integer required

Response

Status 204

See Also

  • task - get the tasks belonging to a given list
  • membership - determine list ownership, members, and whether the list is pending or accepted
  • positions - get the current order for a users' lists
You can report issues or ask questions via our GitHub repository.