Get a paged list of existing payment reminders, optionally filtered to the given parameters.
Get payment reminders filtered and paged (POST)
This endpoint retrieves a paginated list of existing payment reminders, optionally filtered by owner, relation, reminder phase, outstanding amount, or action dates.
A developer calls this endpoint to build an overview of debtors currently in the reminder process, to prioritise collection follow-up by phase or outstanding amount, or to export reminder data for reporting.
Filtering by paymentReminderPhase makes it possible to isolate reminders that require action or have already been escalated.
Request Fields
Field | Type | Required | Description |
|---|---|---|---|
paging.pageSize | integer | No | Number of results per page. Minimum 1, maximum 1000. |
paging.pageNumber | integer | No | Page number to retrieve. Minimum 1, maximum 9999. |
sorting.columnName | string | No | Name of the field to sort results by. |
sorting.order | integer | No | Sort direction. Enum: 0 = Ascending, 1 = Descending. |
filter.reference | string | No | Filters results to the payment reminder with this internal reference. |
filter.ownerReference | string | No | Filters results to reminders raised for this owner. |
filter.relationReference | string | No | Filters results to reminders concerning this relation. |
filter.paymentReminderPhase | integer | No | Filters results to reminders in this phase. Enum: 0 = None, 1 = FirstReminderSent, 2 = SecondReminderSent, 3 = ThirdReminderSent, 4 = Excluded, 5 = Closed, 6 = InProgress, 7 = SentToDebtCollectingAgency, 8 = Archived. |
filter.showAsActionRequiredFrom.from | datetime | No | Lower bound (inclusive) for the action-required date. ISO 8601 format. |
filter.showAsActionRequiredFrom.to | datetime | No | Upper bound (inclusive) for the action-required date. ISO 8601 format. |
filter.lastActionOn.from | datetime | No | Lower bound (inclusive) for the last action date. ISO 8601 format. |
filter.lastActionOn.to | datetime | No | Upper bound (inclusive) for the last action date. ISO 8601 format. |
filter.totalOutstandingAmount.from | decimal | No | Lower bound (inclusive) for the reminder's total outstanding amount. |
filter.totalOutstandingAmount.to | decimal | No | Upper bound (inclusive) for the reminder's total outstanding amount. |
filter.totalOutstandingAmountRecalculateDate.from | datetime | No | Lower bound (inclusive) for the last outstanding amount recalculation. ISO 8601 format. |
filter.totalOutstandingAmountRecalculateDate.to | datetime | No | Upper bound (inclusive) for the last outstanding amount recalculation. ISO 8601 format. |
Response Fields
Field | Type | Required | Description |
|---|---|---|---|
paging.pageSize | integer | Yes | Number of results per page, as applied to this response. |
paging.pageNumber | integer | Yes | Page number returned in this response. |
sorting.columnName | string | Yes | Field the results were sorted by. |
sorting.order | integer | Yes | Sort direction applied. Enum: 0 = Ascending, 1 = Descending. |
paymentReminders | array of objects | No | Collection of payment reminders matching the filter for this page. See the fields below. |
paymentReminders[].reference | string | No | Internal reference of the payment reminder. |
paymentReminders[].ownerReference | string | No | Reference to the owner the payment reminder was raised for. |
paymentReminders[].relationReference | string | No | Reference to the relation the payment reminder concerns. |
paymentReminders[].paymentReminderPhase | integer | Yes | Current phase of the reminder process. Enum: 0 = None, 1 = FirstReminderSent, 2 = SecondReminderSent, 3 = ThirdReminderSent, 4 = Excluded, 5 = Closed, 6 = InProgress, 7 = SentToDebtCollectingAgency, 8 = Archived. |
paymentReminders[].showAsActionRequiredFrom | datetime | Yes | Date and time from which this reminder should be shown as requiring action. ISO 8601 format. |
paymentReminders[].lastActionOn | datetime | No | Date and time the last action was taken on this reminder. ISO 8601 format. |
paymentReminders[].totalOutstandingAmount | decimal | Yes | Total outstanding amount across all sales invoices covered by this reminder. |
paymentReminders[].totalOutstandingAmountRecalculateDate | datetime | Yes | Date and time at which totalOutstandingAmount was last recalculated. ISO 8601 format. |
Ascending = 0 Descending = 1
None = 0 FirstReminderSent = 1 SecondReminderSent = 2 ThirdReminderSent = 3 Excluded = 4 Closed = 5 InProgress = 6 SentToDebtCollectingAgency = 7 Archived = 8
OK
Ascending = 0 Descending = 1
None = 0 FirstReminderSent = 1 SecondReminderSent = 2 ThirdReminderSent = 3 Excluded = 4 Closed = 5 InProgress = 6 SentToDebtCollectingAgency = 7 Archived = 8