List batches

Use this method to retrieve a paginated list of your merchants’ batches that were submitted to the processor on a specific date.

Note: If you want to view a specific batch and you have its batchId, use our Retrieve Batch method.

In your request, include the date that the batch was submitted. You can also use a query parameter to view the batches of a specific merchant.

Our gateway returns the following information about each batch in the list:

  • Transaction information, including the number of transactions and total value of sales.
  • Merchant information, including the merchant ID (MID) and the processing account that the batch is associated with.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

beforestringOptional
Points to the resource identifier that you want to receive your results before. Typically, this is the first resource on the previous page.
afterstringOptional
Points to the resource identifier that you want to receive your results after. Typically, this is the last resource on the previous page.
limitintegerOptional<=100Defaults to 10
States the total amount of results the response is limited to.
datedateRequired

Filter batches by the date that they were submitted. The format of this value is YYYY-MM-DD.

merchantIdstringOptional
Filter results by the unique identifier that the processor assigned to the merchant.

Response

Successful request. Returns a paginated list of batches.
datalist of objects
Array of batch objects.
countdouble or null
Number of results that we returned.
hasMoreboolean or null
Indicates that further results are available.
limitdouble or null
Maximum number of results that we return for each page.

Errors