Check QMR generation status

Here, you will learn how to check the generation status of QMR in Tuum.

Use case

In this use case, we will demonstrate how to check the generation status of a requested QMR.

Use case data	API parameters with values
The generationId parameter is obtained from the manually generated QMR that was previously requested.	...api/v2/generations/ID-13061

Sample API call

To find the status of the requested report, make the following API call.

reports-api.sandbox.tuumplatform.com/ api/v2/generations/{generationId}

Learn more about the find generation by generation ID endpoint in the Tuum developer portal.

Sample request

The sample request body is as follows:

JSON

No request body.

cURL

curl -L 'https://reports-api.sandbox.tuumplatform.com/api/v2/generations/ID-13061' \
-H 'x-tenant-code: MB' \
-H 'Accept-Language: en' \
-H 'x-auth-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJuYW1lIjoidGVzdGkgdGVzdCIsImVtcGxveWVlSWQiOiJJRC0xNDE3IiwidGVuYW50Q29kZSI6Ik1CIiwiZXhwaXJ5RFRpbWUiOiIyMDI1LTEwLTIyVDA5OjQ4OjMyIiwiZXhwIjoxNzYxMTI2NTEyLCJyb2xlcyI6WyJBRE1JTiIsIlNZU1RFTSJdfQ.7TVoQhmqGBjZuDajPYh2rEJyXbJ27Xf3w9ZPQVEMnk4'

Sample response

Below you will find the response to the API request:

Response

{
    "errors": null,
    "validationErrors": null,
    "data": {
        "generationId": "ID-13061",
        "generationTypeCode": "CARD_MQMR",
        "generationGroupCode": "CARD",
        "statusCode": "DONE",
        "createdDTime": "2025-10-22T08:01:53.971Z",
        "entryDate": null,
        "inputJson": "{\"binNumber\":\"111172\",\"exportFileType\":\"PDF\",\"reportingPeriod\":{\"startDate\":\"2025-07-01\",\"endDate\":\"2025-10-01\"}}",
        "errorCode": null,
        "source": null,
        "fileInfos": [
            {
                "generationFileId": "ID-11417",
                "fileName": "MastercardQMR-111172-2025-07-01-2025-10-01.pdf",
                "storageSource": {
                    "sourceName": "STORAGE.FILE",
                    "sourceRef": "ID-4359"
                },
                "additionalData": null
            }
        ],
        "previewJson": null
    }
}

Result

This endpoint returns the status of the QMR. When the statusCode value is DONE, the report is ready for export. In this example, the sourceRef for exporting the PDF file is ID-4359.