v1

latestOpenAPI 3.0.12026-07-2353480642.4 KB
Reports

Get the list of all reports

By passing in the appropriate options, you can search for reports in the system.

get/reports

Query parameters

pageNumberinteger

Page number for records.

pageSizeinteger

Page size for returned records.

orderBystring

The ordering sequence of the selected records. If this parameter is not provided, descending order will be chosen.

ValueDescription
ASCAscending order
DESCDescending order
orderCriteriastring

The ordering criteria of the selected records.

If this parameter not provided, the result will be ordered by <b>createdOn</b>.

ValueDescription
createdOnDate & Time
modifiedOnDate & Time
statusReport status
mimeTypeMime type
reportTypeReport type
reportUidReport identifier
searchstring

<b>A filter query in RSQL format.</b>

The returned reports are limited to those that can be retrieved by the user. Please note that if reportEntityUid is not provided as a search criteria, only records will be returned for the current reportEntityUid assigend to that user (and does not include descendants).

CriteriaDescriptionOperator Used
createdOnThe date and time the report was created (Date & Time)==,=lt=,=le=,=gt=,=ge=,=in=,=out=
modifiedOnDate & Time==,=lt=,=le=,=gt=,=ge=,=in=,=out=
statusReport status==,=in=,=out=
mimeTypeMime type==,=in=,=out=
reportTypeReport type==,=in=,=out=
reportUidReport identifier==,=regex=,=in=,=out=
reportEntityUidReport entity UUID==,=in=
reportParameter.batchUUIDThe unique identifier of the settlement batch this report is related to. Mapped to PDSP's transaction.context.paymentContext.batchUUID.==,=in=
reportParameter.settlementBatchFileNumberThe identifier of the settlement batch file this report is related to. Mapped to PDSP's transaction.settlementContext.settlementBatchFileNumber.==,=regex=,=in=,=out=
reportParameter.clearingEntityUidClearing entity UUID==,=in=
reportParameter.clearingAccountUidclearingAccountUid==,=in=
reportParameter.clearingDateclearingDate (Date & Time)==,=lt=,=le=,=gt=,=ge=,=in=,=out=
reportParameter.clearingMerchantNameclearingMerchantName==,=regex=,=in=,=out=
reportParameter.clearingUidclearingUid==,=in=
reportParameter.clearingBankAccountclearingBankAccount==,=in=
reportParameter.bankingPartnerbankingPartner==,=regex=,=in=,=out=
reportParameter.clearingBankCodeclearingBankCode==,=regex=,=in=,=out=
reportParameter.clearingMerchantIdclearingMerchantId==,=regex=,=in=,=out=
reportParameter.clearingReferenceclearingReference==,=regex=,=in=,=out=
reportParameter.generatedOn (deprecated)generatedOn==,=lt=,=le=,=gt=,=ge=,=in=,=out=
reportParameter.invoicePeriodFrominvoicePeriodFrom==,=lt=,=le=,=gt=,=ge=,=in=,=out=
reportParameter.invoicePeriodToinvoicePeriodTo==,=lt=,=le=,=gt=,=ge=,=in=,=out=
reportParameter.invoiceNumberinvoiceNumber==,=regex=,=in=,=out=
reportParameter.reportDescriptionreportDescription==,=regex=,=in=,=out=
reportParameter.reportableDayreportableDay==,=lt=,=le=,=gt=,=ge=,=in=,=out=

<b>RSQL Operators</b> RSQL Query is composed of one or more expressions, combined to each other with following logical operators:

OperatorSyntax
Logical AND<b>;</b> or <b>&</b>
Logical OR<b>,</b>

<b>RSQL Comparators</b>

ComparatorDescription
==equal
!=not equal
=lt=less than
=le=less than and equal to
=gt=greater than
=ge=greater than and equal to
=regex=pattern matching
=in=multiple arguments search
=out=exclude

<b>Examples</b>

  • /reports?search=reportType=in=(MERCHANT_SETTLEMENT_REPORT,DAILY_TRANSACTION_REPORT);createdOn=gt=2020-09-20T00:00:00.000Z

  • /reports?search=reportEntityUid=in=(2cbc7ec7-49dd-4e70-be98-dd751cf8640b,0d7e19f7-94d5-49ad-890d-1ce636912fb7,a3ca2522-2810-4db1-b535-6e449c3cea6c)

  • /reports?search=reportParameter.clearingReference==12345

Response

search results matching criteria

totalsinteger

Total number of reports. The total number of reports matching the search criteria, which can be larger than the number of elements in the array "reports" (which is upper bound by the "pageSize" parameter from the query request).