TOtodoist
Labels

Get Label

Return a personal label by ID.

Returns NOT_FOUND when the label does not exist or the ID is invalid.

get/api/v1/labels/{label_id}

Request

  • Base URL
    https://api.todoist.com
  • URL
    https://api.todoist.com/api/v1/labels/{label_id}
  • Auth
    none declared

Path parameters

label_idinteger required

String ID of the label

Response

Successful Response

idstring required

String ID of the label.

namestring required

Label name.

colorstring required

Label color name.

orderinteger nullable required

Position of the label in the label list, or null when no explicit order is set.

is_favoriteboolean required

Whether the label is marked as a favorite.

Example response

{
  "id": "2147509004",
  "name": "Priority",
  "color": "berry_red",
  "order": 12
}

Changes

No recorded changes to this operation across all 34 revisions of this API.