Sign in

v1

latestOpenAPI 3.0.1MIT2026-07-261190449.2 KB
Payments

List of Payments

Returns a list of payments with metadata. Payments happen according to the payment frequency of the organization. They include and consider all relevant transactions and other payments during the specified period. You can use the limit, page, sortBy and sortDirection parameters to filter and sort the results.

get/payments

Query parameters

organizationIdstring uuid required

The ID of the organization to get the payments for.

cardAccountIdstring uuid

The ID of the card account to get the payments for.

type'BILL' | 'TOPUP' | 'DIRECT_DEBIT_REVERSAL' | 'PAYOUT'

The type of the payments to filter by.

status'PLANNED' | 'UPCOMING' | 'DEFERRED' | 'READY_FOR_PMT' | 'PENDING' | 'PAID' | 'FAILED' | 'DISCARDED' | 'BOOKED' | 'REVERSED'

The status of the payments to filter by.

fromDatestring date-time nullable
Example:2021-01-30T08:30:00Z

The date from which to return payments, zero-offset UTC time. The date boundary is inclusive. Meaning we compare with >=.

toDatestring date-time nullable
Example:2021-01-30T08:30:00Z

The date until which to return payments, zero-offset UTC time. The date boundary is inclusive. Meaning we compare with <=.

byDateField'cutoffDate' | 'collectionDate' | 'paymentDate' | 'updatedAt' | 'createdAt' nullable

Desired date field to be filtered by if fromDate or toDate present.

limitinteger

The maximum number of items to return per page. The default value if not provided is 100, the maximum allowed value is 1000.

pageinteger

The page number to return, starting with 0, this counts up to the total number of pages. The total number of pages is determined by the total number of records divided by the limit.

sortBy'organizationId' | 'status' | 'type' | 'cutoffDate' | 'collectionDate' | 'paymentDate' | 'createdAt'

The field to sort by.

sortDirection'ASC' | 'DESC'

The direction to sort by.

Response

Ok

hasNextPageboolean

Indicates whether there is a next page available.