---
title: "Retrieve an invoice's reminder schedule"
method: GET
path: "/v1/invoices/{id}/reminders"
tags: ["Invoices"]
---

# Retrieve an invoice's reminder schedule

`GET /v1/invoices/{id}/reminders`

Returns the automatic-reminder timeline for one invoice owned by the caller's organization: each milestone's scheduled date and sent state, the sent/total counts, and the next upcoming reminder.

## Path parameters

- `id` string, required

## Response `200`

OK

- object — Standard response containing data and its metadata if any
  - `data` ReminderScheduleResponseDTO
    - `enabled` boolean
    - `milestones` ReminderMilestoneDTO[]
      - `date` string
      - `key` string
      - `offset_days` integer — OffsetDays relative to the due date (negative = before, 0 = on, positive = after). Lets the UI label the milestone generically ("3 days before due") without hardcoding the cadence keys, so a config change flows through.
      - `sent` boolean
      - `sent_at` string
    - `next_reminder_at` string
    - `sent_count` integer
    - `total` integer
  - `has_more` boolean

## Other responses

- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

---

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