Request to generate QMR manually

Here, you will learn how to generate quarterly Mastercard report (QMR) in Tuum.

Use case

In this example, we will demonstrate how to request to generate the QMR for the third quarter of 2025.

Use case data	API parameters with values
The report includes Mastercard data for BIN 111172.	"binNumber": "111172"
The type of report file that is going to be generated.	"exportFileType": "PDF"
The reporting period is the third quarter of 2025.	"reportingPeriod": { "startDate": "2025-07-01", "endDate": "2025-10-01" }

Sample API call

To request the quarterly Mastercard report, use the following endpoint:

https://reports-api.sandbox.tuumplatform.com/api/v1/card/mqmr/export

Learn more about the card MQMR export endpoint in the Tuum developer portal.

Sample request

The sample request body is as follows:

Body

{
  "binNumber": "111172",
  "exportFileType": "PDF",
  "reportingPeriod": {
    "startDate": "2025-07-01",
    "endDate": "2025-10-01"
  }
}

cURL

curl -L 'https://reports-api.sandbox.tuumplatform.com/api/v1/card/mqmr/export' \
-H 'x-tenant-code: MB' \
-H 'Accept-Language: en' \
-H 'x-auth-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJuYW1lIjoidGVzdGkgdGVzdCIsImVtcGxveWVlSWQiOiJJRC0xNDE3IiwidGVuYW50Q29kZSI6Ik1CIiwiZXhwaXJ5RFRpbWUiOiIyMDI1LTEwLTIxVDEwOjIxOjEwIiwiZXhwIjoxNzYxMDQyMDcwLCJyb2xlcyI6WyJBRE1JTiIsIlNZU1RFTSJdfQ.P-_CWPnpAm2Xb5UBWE6tHjzTYqg5f4GNrFw7p8Fo8D0' \
-H 'Content-Type: application/json' \
-d '{
  "binNumber": "111172",
  "exportFileType": "PDF",
  "reportingPeriod": {
    "startDate": "2025-07-01",
    "endDate": "2025-10-01"
  }
}'

Sample response

Below you will find the response to the API request:

Response

{
    "errors": null,
    "validationErrors": null,
    "data": {
        "generationId": "ID-13061",
        "generationTypeCode": "CARD_MQMR",
        "groupTypeCode": "CARD",
        "statusCode": "PENDING",
        "createdDTime": "2025-10-22T08:01:53.971Z",
        "inputJson": "{\"binNumber\":\"111172\",\"exportFileType\":\"PDF\",\"reportingPeriod\":{\"startDate\":\"2025-07-01\",\"endDate\":\"2025-10-01\"}}",
        "errorCode": null,
        "source": null,
        "previewEnabled": false
    }
}

Result

This endpoint initiates the manual generation of a QMR. When the statusCode value is PENDING, the report generation is in progress and the status can be checked. In this example, the generationId for checking the QMR generation status is ID-13061.