---
title: "GET /tools/api/list-payment-reminders"
method: GET
path: "/tools/api/list-payment-reminders"
tags: ["Payment Reminders"]
---

# GET /tools/api/list-payment-reminders

`GET /tools/api/list-payment-reminders`

Lista todos os lembretes de pagamento do usuário com informações de cota. Permite filtrar por status (active, all, upcoming, overdue). Requer API key para autenticação e assinatura ativa.

## Query parameters

- `filter` 'active' | 'all' | 'upcoming' | 'overdue'
- `days` integer

## Response `200`

Lista de lembretes de pagamento

- object
  - `success` boolean
  - `data` PaymentReminder[]
    - `id` string
    - `title` string
    - `amount` number, nullable
    - `dueDate` string, date, nullable
    - `reminderTime` string, date-time, nullable
    - `status` 'active' | 'completed' | 'inactive'
    - `isRecurring` boolean
    - `recurrencePattern` string, nullable
    - `createdAt` string, date-time
  - `count` number
  - `filter` string
  - `quota` PaymentReminderQuota
    - `subscriptionType` 'basic' | 'pro' | 'premium'
    - `currentCount` number
    - `limit` number
    - `canCreate` boolean
    - `remaining` number
  - `timestamp` string, date-time

## Other responses

- `401` — Authentication or subscription error
- `500` — Internal server error

---

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