GET

Get a List

Get information about a List

Request

Path parameters

id

string

Required

Query parameters

fields

string

Responses

Success

GET/lists/{id}
1 2 curl --request GET \ --url 'https://api.trello.com/1/lists/{id}?key=APIKey&token=APIToken'
PUT

Update a List

Update the properties of a List

Request

Path parameters

id

string

Required

Query parameters

name

string

closed

boolean

idBoard

TrelloID

pos

oneOf [number, string]

subscribed

boolean

Responses

Success

PUT/lists/{id}
1 2 curl --request PUT \ --url 'https://api.trello.com/1/lists/{id}?key=APIKey&token=APIToken'
POST

Create a new List

Create a new List on a Board

Request

Query parameters

name

string

Required
idBoard

TrelloID

Required
idListSource

TrelloID

pos

oneOf [number, string]

Responses

Success

POST/lists
1 2 curl --request POST \ --url 'https://api.trello.com/1/lists?name={name}&idBoard=5abbe4b7ddc1b351ef961414&key=APIKey&token=APIToken'
POST

Archive all Cards in List

Archive all cards in a list

Request

Path parameters

id

TrelloID

Required

Responses

Success

POST/lists/{id}/archiveAllCards
1 2 curl --request POST \ --url 'https://api.trello.com/1/lists/{id}/archiveAllCards?key=APIKey&token=APIToken'
POST

Move all Cards in List

Move all Cards in a List

Request

Path parameters

id

TrelloID

Required

Query parameters

idBoard

TrelloID

Required
idList

TrelloID

Required

Responses

Success

POST/lists/{id}/moveAllCards
1 2 curl --request POST \ --url 'https://api.trello.com/1/lists/{id}/moveAllCards?idBoard=5abbe4b7ddc1b351ef961414&idList=5abbe4b7ddc1b351ef961414&key=APIKey&token=APIToken'
PUT

Archive or unarchive a list

Archive or unarchive a list

Request

Path parameters

id

TrelloID

Required

Query parameters

value

TrelloID

Responses

Success

PUT/lists/{id}/closed
1 2 curl --request PUT \ --url 'https://api.trello.com/1/lists/{id}/closed?key=APIKey&token=APIToken'
PUT

Move List to Board

Move a List to a different Board

Request

Path parameters

id

TrelloID

Required

Query parameters

value

TrelloID

Required

Responses

Success

PUT/lists/{id}/idBoard
1 2 curl --request PUT \ --url 'https://api.trello.com/1/lists/{id}/idBoard?value=5abbe4b7ddc1b351ef961414&key=APIKey&token=APIToken'
PUT

Update a field on a List

Rename a list

Request

Path parameters

id

TrelloID

Required
field

string

Required

Query parameters

value

oneOf [string, number, string, boolean]

Responses

Success

PUT/lists/{id}/{field}
1 2 curl --request PUT \ --url 'https://api.trello.com/1/lists/{id}/{field}?key=APIKey&token=APIToken'
GET

Get Actions for a List

Get the Actions on a List

Request

Path parameters

id

string

Required

Query parameters

filter

string

Responses

Success

GET/lists/{id}/actions
1 2 curl --request GET \ --url 'https://api.trello.com/1/lists/{id}/actions?key=APIKey&token=APIToken'
GET

Get the Board a List is on

Get the board a list is on

Request

Path parameters

id

string

Required

Query parameters

fields

string

Responses

Success

GET/lists/{id}/board
1 2 curl --request GET \ --url 'https://api.trello.com/1/lists/{id}/board?key=APIKey&token=APIToken'
GET

Get Cards in a List

List the cards in a list

Request

Path parameters

id

TrelloID

Required

Responses

Success

application/json

array<Card>

GET/lists/{id}/cards
1 2 3 curl --request GET \ --url 'https://api.trello.com/1/lists/{id}/cards?key=APIKey&token=APIToken' \ --header 'Accept: application/json'
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 [ { "id": "5abbe4b7ddc1b351ef961414", "address": "<string>", "badges": { "attachmentsByType": { "trello": { "board": 2154, "card": 2154 } }, "location": true, "votes": 2154, "viewingMemberVoted": false, "subscribed": false, "fogbugz": "<string>", "checkItems": 0, "checkItemsChecked": 0, "comments": 0, "attachments": 0, "description": true, "due": "<string>", "start": "<string>", "dueComplete": true }, "checkItemStates": [ "<string>" ], "closed": true, "coordinates": "<string>", "creationMethod": "<string>", "dateLastActivity": "2019-09-16T16:19:17.156Z", "desc": "👋Hey there,\n\nTrello's Platform team uses this board to keep developers up-to-date.", "descData": { "emoji": {} }, "due": "<string>", "dueReminder": "<string>", "idBoard": "5abbe4b7ddc1b351ef961414", "idChecklists": [ { "id": "5abbe4b7ddc1b351ef961414" } ], "idLabels": [ { "id": "5abbe4b7ddc1b351ef961414", "idBoard": "5abbe4b7ddc1b351ef961414", "name": "Overdue", "color": "yellow" } ], "idList": "5abbe4b7ddc1b351ef961414", "idMembers": [ "5abbe4b7ddc1b351ef961414" ], "idMembersVoted": [ "5abbe4b7ddc1b351ef961414" ], "idShort": 2154, "labels": [ "5abbe4b7ddc1b351ef961414" ], "limits": { "attachments": { "perBoard": {} } }, "locationName": "<string>", "manualCoverAttachment": false, "name": "👋 What? Why? How?", "pos": 65535, "shortLink": "H0TZyzbK", "shortUrl": "https://trello.com/c/H0TZyzbK", "subscribed": false, "url": "https://trello.com/c/H0TZyzbK/4-%F0%9F%91%8B-what-why-how", "cover": { "color": "yellow", "idUploadedBackground": true, "size": "normal", "brightness": "light", "isTemplate": false } } ]

Rate this page: