---
title: "Get to-do lists for an address"
method: GET
path: "/addresses/{address_id}/todos"
tags: ["To-Do Lists"]
---

# Get to-do lists for an address

`GET /addresses/{address_id}/todos`

## Request

- Base URL: `https://api.tidy.com/v1`
- URL: `https://api.tidy.com/v1/addresses/{address_id}/todos`
- Auth: API key in header `X-API-Key`

Retrieve all to-do lists associated with an address

## Path parameters

- `address_id` integer, required

## Response `200`

Successful response

- object
  - `todos` TodoList[]
    - `id` integer
    - `name` string
    - `items` TodoItem[]
      - `id` integer
      - `description` string
      - `completed` boolean
      - `order` integer

---

[API](https://skmtc.dev/tidy/apis/tidy-api.md) · [All operations](https://skmtc.dev/tidy/apis/tidy-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tidy/apis/tidy-api/revisions/c13f59ecd759?raw)