Documentation Index

Fetch the complete documentation index at: https://www.bloxs.io/llms.txt

Use this file to discover all available pages before exploring further.

Get payment reminders filtered and paged

Prev Next
Post
/api/v1/invoices/paymentreminders/filter

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.

Security
Body parameters
Expand All
object
paging
object (PagingInfo)
pageSize
integer (int32) | null
Minimum1
Maximum1000
pageNumber
integer (int32) | null
Minimum1
Maximum9999
sorting
object (SortingInfo)
columnName
string | null
order
integer (int32)

Ascending = 0 Descending = 1

filter
object (PaymentReminderSearchRequestFilter)
reference
string | null
ownerReference
string | null
relationReference
string | null
paymentReminderPhase
integer (int32) | null

None = 0 FirstReminderSent = 1 SecondReminderSent = 2 ThirdReminderSent = 3 Excluded = 4 Closed = 5 InProgress = 6 SentToDebtCollectingAgency = 7 Archived = 8

showAsActionRequiredFrom
object (CompareFilterModelDateTime)
from
string (date-time) | null
to
string (date-time) | null
lastActionOn
object (CompareFilterModelDateTime)
from
string (date-time) | null
to
string (date-time) | null
totalOutstandingAmount
object (CompareFilterModelDecimal)
from
number (double) | null
to
number (double) | null
totalOutstandingAmountRecalculateDate
object (CompareFilterModelDateTime)
from
string (date-time) | null
to
string (date-time) | null
Responses
200

OK

Expand All
object
paging
object (PagingInfo)
pageSize
integer (int32) | null
Minimum1
Maximum1000
pageNumber
integer (int32) | null
Minimum1
Maximum9999
sorting
object (SortingInfo)
columnName
string | null
order
integer (int32)

Ascending = 0 Descending = 1

paymentReminders
Array of object (PaymentReminderSearchResultFilter) | null
object
reference
string | null
ownerReference
string | null
relationReference
string | null
paymentReminderPhase
integer (int32)

None = 0 FirstReminderSent = 1 SecondReminderSent = 2 ThirdReminderSent = 3 Excluded = 4 Closed = 5 InProgress = 6 SentToDebtCollectingAgency = 7 Archived = 8

showAsActionRequiredFrom
string (date-time)
lastActionOn
string (date-time) | null
totalOutstandingAmount
number (double)
totalOutstandingAmountRecalculateDate
string (date-time)