Custom Reporting API Overview

BlueSnap's Custom Reporting API is a RESTful web service that enables you to create, manage, and run your own reports. You start with one of the available report categories and select the columns you want to include. For example, you might wish to create a custom transaction report that only includes the columns Merchant Transaction ID, transaction amount, currency, and date.

API web services

These are the core web services in the Custom Reporting API.

To manage your reports, see:

To run your reports, see:


Pulling a Single Report for Multiple Merchant IDs

If you're using our Custom Reporting API, you can pull a single, unified report for multiple merchant IDs (MIDs) by including the merchantIds parameter in your API request. You can find more information about the merchantIds parameter under Query Parameter Descriptions.

The merchantIDs parameter allows you to pull reports with multiple MIDs, whether you are a partner with multiple merchants or a merchant with multiple MIDs.

Keep in mind that in order to use multi-MID reporting functionality, you need to access reports from the parent MID (or partner MID if applicable). You can not access multi-MID reporting through child MIDs.

API base URLs

These are the base URLs for the BlueSnap environments.

  • Sandbox:
  • Production:


Every API request must be authenticated using an HTTP Basic Authentication header.

API credentials

If you do not yet have API credentials, follow these steps to obtain them.