v1

latestOpenAPI 3.1.0© Modulr Finance2026-08-04207430590.4 KB
Payments

Get batch payments by a given set of parameters

This endpoint allows for a user who has submitted multiple batch to use some criteria to get the batch payments.

get/batchpayments

Query parameters

idstring[]

List of batch payment IDs

List of batch payment IDs

externalReferencestring

Batch payments External Reference contains this text.

Example:aReference_00001

Batch payments External Reference contains this text.

fromCreatedDatestring date

Batch payments created date equal or after to this date.

Example:2022-05-16

Batch payments created date equal or after to this date.

toCreatedDatestring date

Batch payments created date equal or before this date.

Example:2026-06-08

Batch payments created date equal or before this date.

batchPaymentStatusesstring[]
paymentStatusesstring[]
approvalStatusstring[]

Payment approval status, multiple statuses can be specified by repeating the parameter

currentUserCanApproveboolean

Only return batch payments the current user can approve.

Example:true

Only return batch payments the current user can approve.

createdByCustomerIdstring

Limit results by the customer which created the batch payment request

Limit results by the customer which created the batch payment request

submissionType'BATCH' | 'BULK'

Limit results to batches with submission type specified

Limit results to batches with submission type specified

pageinteger

Page to fetch (0 indexed)

Page to fetch (0 indexed)

sizeinteger

Size of Page to fetch

Size of Page to fetch

Response

OK

sizeinteger required

Page size

totalSizeinteger required

Total count

pageinteger required

Current page number, 0-based, i.e first page = 0, second page = 1

totalPagesinteger required

Total pages

Example response

{
  "content": [
    {
      "id": "D920000001",
      "externalReference": "aReference_00001",
      "status": "ACCEPTED",
      "totalPayments": 9123,
      "currentUserCanApprove": true,
      "approvals": [
        {
          "approvedBy": "U2100021",
          "approvedOn": "2022-06-25"
        }
      ],
      "createdDate": "2017-01-28T01:01:01+0000",
      "processingDateFrom": "2017-01-28",
      "processingDateTo": "2017-01-28",
      "earliestScheduledPaymentDate": "2017-01-28"
    }
  ]
}