---
title: "List personal deadlines"
method: GET
path: "/deadlines"
---

# List personal deadlines

`GET /deadlines`

## Request

- Base URL: `https://www.scadenzario.app/api/v1`
- URL: `https://www.scadenzario.app/api/v1/deadlines`
- Auth: HTTP bearer

## Query parameters

- `status` 'active' | 'completed' | 'all'
- `from` string
- `to` string
- `q` string
- `label_id` string[]
- `paid` 'true' | 'false'
- `recurring` 'true' | 'false'
- `overdue` 'true' | 'false'
- `limit` integer
- `cursor` string

## Response `200`

One page of matching deadlines.

- DeadlinePage
  - `data` Deadline[], required
    - `id` string, required
    - `title` string, required
    - `due_at` string, date-time, required
    - `notes` string, nullable
    - `emoji` string, nullable
    - `recurrence` 'none' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'multiple_daily' | 'interval' | 'specific_dates' | 'yearly_dates' | 'quarterly' | 'bimonthly' | 'biennial' | 'semiannual', required
    - `custom_interval` integer
    - `reminder_days` integer[]
    - `notification_times` string[]
    - `amount` number, nullable
    - `transaction_type` 'none' | 'expense' | 'income'
    - `is_paid` boolean
    - `paid_at` string, date-time, nullable
    - `paid_amount` number, nullable: Amount actually paid, when it differs from amount.
    - `is_done` boolean, required
    - `label_id` string, nullable
    - `label_ids` string[]
    - `has_attachment` boolean
    - `created_at` string, nullable
    - `updated_at` string, nullable
  - `next_cursor` string, nullable, required: Pass back as cursor for the next page; null at the end.
  - `truncated` boolean, required: True when the scan hit its cap before filling the page: keep going with next_cursor.

## Other responses

- `400`: Invalid filter or cursor.
- `401`: Missing or invalid token.
- `429`: Rate limited (60 req/min).

---

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