Optimization Protection

Retrieve the status of bulk consumer profile import

You can retrieve the status of your bulk consumer profile import by performing a GET call to the /bulk-import/status endpoint and providing the values for the following fields in the headers:

merchantFileName — The file name of the bulk import file.
merchantIdentifier — Unique entity for transaction processing.
submitterIdentifier — The submitter ID of the bulk import file.

HTTP method: GET

Endpoint: /bulk-import/status

Scenario: Retrieving the status of a bulk import for merchantIdentifier = 111111111111, submitteridentifier = orbital, and merchantfilename = orbitalM_111111111111_2025051270892_68848_data.csv

Json

{
    "requestId": null,
    "merchantId": "111111111111",
    "merchantFileName": "orbitalM_111111111111_2025051270892_68848_data.csv",
    "submitterIdentifier": "orbital",
    "totalRecordCount": 10,
    "processedRecordCount": 0,
    "erroredRecordCount": 0,
    "fileReceivedTimestamp": "2025-05-12T00:00:26.071137092",
    "finalResponseTimestamp": "2025-05-12 01:21:48",
    "ackResponseTimestamp": "2025-05-12T00:23:51.129577795",
    "errorResponseTimestamp": null,
    "fileFormat": "COLUMN_BASED",
    "fileVersion": "v1",
    "overallFileStatus": "COMPLETED_SUCCESSFULLY",
    "overallFileStatusDescription": null,
    "fileProcessCompletionPercent": "100.0",
    "bulkTokenizationStatus": {
        "toknRequestFilesExpectedCount": 1,
        "toknRequestFilesCreatedCount": 0,
        "toknResponseFilesReceivedCount": 0,
        "toknRequestFilesSentPercent": "0.0",
        "toknResponseFilesReceivedPercent": "0.0"
    }
}

Consumer profiles

Retrieve the status of bulk consumer profile import

Related