---
title: "GET /v1/todos/list"
method: GET
path: "/v1/todos/list"
tags: ["TodoService"]
---

# GET /v1/todos/list

`GET /v1/todos/list`

ListTodos returns a page of todo items, optionally filtered and ordered.
 Use the next_page_token from TodoSet to retrieve subsequent pages.
 Returns INVALID_ARGUMENT if filter, order_by, or page_token are malformed.

## Query parameters

- `pageSize` integer
- `pageToken` string
- `filter` string
- `orderBy` string

## Response `200`

OK

- TodoV1TodoSet — TodoSet is a paginated collection of todo items returned by ListTodos.
  - `todos` TodoV1Todo[] — The page of todo items in the order requested by ListTodosRequest.order_by.
    - `id` string — Server-assigned unique identifier. Read-only on create.
    - `title` string — Short human-readable title.
    - `content` string — Detailed description or notes for the todo item.
    - `completed` boolean — Whether the todo item has been completed.
    - `createTime` string, date-time — Time at which the todo item was created. Server-assigned, read-only.
    - `updateTime` string, date-time — Time at which the todo item was last modified. Server-assigned, read-only.
  - `nextPageToken` string — Token used to retrieve the next page via ListTodosRequest.page_token. Empty when there are no more results.

---

[API](https://skmtc.net/go-kratos/apis/todoservice-api.md) · [All operations](https://skmtc.net/go-kratos/apis/todoservice-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/go-kratos/todoservice-api/versions/d99daada47f9/schema)