Unify and manage your data

Get Tasks History

The API returns finished export tasks for all tenants.

The Get Tasks History API returns export tasks for all tenants. You must be an administrator to execute this API. This API returns tasks with the following statuses:

  • CANCELED
  • COMPLETED
  • FAILED
Request
GET {ExportServiceURL}/tasks/history
Table 1. Parameters
Name Required Details
maxNo

The parameter represents the positive integer value to identify the maximum number of tasks to return in a response.  The default value is 50.

offsetNo

The parameter represents the positive Integer value to identify starting what element in a result set should be returned in a response. Can be used to organize pagination in combination with max parameter. The default value is 0.

Response

An array of completed export tasks.

[
    {
        "id": "0f5681c9-39a2-4fc1-981d-ba4db25ab995",
        "groupId": "0f5681c9-39a2-4fc1-981d-ba4db25ab995",
        "createdTime": 1697120262317,
        "createdBy": "john.smith",
        "updatedTime": 1697127096358,
        "updatedBy": "john.smith",
        "type": "com.reltio.export.tasks.v4.ExportTask",
        "status": "COMPLETED",
        "name": "relation-export-task[apanchenko123_14-17_relations_0c4156]",
        "parallelExecution": false,
        "nodesGroup": "etalon-idev-02-jobs",
        "startTime": 1697120356793,
        "endTime": 1697127077503,
        "parameters": {
            "tenantId": "apanchenko123",
            "username": "john.smith",
            "mailAddress": "john.smith@reltio.com",
            "taskId": "jsmith123_14-17_relations_0c4156",
            "exportName": "jsmith123_14-17_relations",
            "exportPath": "relations/john.smith/2023/12-Oct-2023",
            "fileFormat": "CSV",
            "dateFormat": "TIMESTAMP",
            "ovOnly": "true",
            "encryptUrl": "true",
            "exportVotes": "false",
            "includeType": "[\"configuration/relationTypes/HasAddress\"]",
            "queryParams": "{}",
            "specifiedMailAddress": "john.smith@reltio.com",
            "exportType": "RELATIONS",
            "activeness": "ALL",
            "headersStyle": "name",
            "sePrefix": "false",
            "skipPostprocessing": "true",
            "fileCompression": "ZIP",
            "headerFormat": "DEFAULT",
            "headerOrder": "DEFAULT"
        },
        "currentState": {
            "globalStatus": {
                "headerTotal": 507016,
                "lastFiveMinReadThroughput": 470,
                "lastFiveMinThroughput": 1707,
                "relationsNumber": 507016,
                "relationsTotal": 507016,
                "headerNumber": 507016,
                "overallThroughput": 150,
                "overallReadThroughput": 153
            },
            "exportUrls": [
                "https://idev-02.reltio.com/download.html?tenant=apanchenko123&downloadExportUrl=...",
                "https://idev-02.reltio.com/download.html?tenant=apanchenko123&downloadExportUrl=...",
                "https://idev-02.reltio.com/download.html?tenant=apanchenko123&downloadExportUrl=...",
                "https://idev-02.reltio.com/download.html?tenant=apanchenko123&downloadExportUrl=..."
            ],
            "statusId": 90,
            "numberOfObjects": 507016,
            "numberOfProcessedObjects": 507016,
            "warnings": "[]",
            "numberOfReadObjects": 507016,
            "status": "Completed"
        },
        "throughput": 227.76999,
        "duration": "37m 6s"
    },
    {
        "id": "7fe02b5b-9685-4f4e-b8c2-3cf6819dbf89",
        "groupId": "7fe02b5b-9685-4f4e-b8c2-3cf6819dbf89",
        "createdTime": 1697119819160,
        "createdBy": "john.smith",
        "updatedTime": 1697121059239,
        "updatedBy": "john.smith",
        "type": "com.reltio.export.tasks.v4.ExportTask",
        "status": "COMPLETED",
        "name": "entity-export-task[jsmith123_14-10_entities_d2d375]",
        "parallelExecution": false,
        "nodesGroup": "etalon-idev-02-jobs",
        "startTime": 1697119874795,
        "endTime": 1697121040077,
        "parameters": {
            "tenantId": "jsmith123",
            "username": "john.smith",
            "mailAddress": "john.smith@reltio.com",
            "taskId": "jsmith123_14-10_entities_d2d375",
            "exportName": "jsmith123_14-10_entities",
            "exportPath": "entities/john.smith/2023/12-Oct-2023",
            "fileFormat": "CSV",
            "dateFormat": "TIMESTAMP",
            "ovOnly": "true",
            "exploded": "false",
            "encryptUrl": "true",
            "includeType": "[\"configuration/entityTypes/HCP\",\"configuration/entityTypes/Contact\",\"configuration/entityTypes/Individual\"]",
            "queryParams": "{\"filter\":\"equals(type,'configuration/entityTypes/Individual') and equals(attributes.FirstName, 'John')\"}",
            "specifiedMailAddress": "john.smith@reltio.com",
            "exportType": "ENTITIES",
            "activeness": "ALL",
            "headersStyle": "name",
            "sePrefix": "false",
            "skipPostprocessing": "true",
            "fileCompression": "ZIP",
            "headerFormat": "DEFAULT",
            "headerOrder": "DEFAULT"
        },
        "currentState": {
            "globalStatus": {
                "headerTotal": 99805,
                "lastFiveMinReadThroughput": 231,
                "lastFiveMinThroughput": 356,
                "entitiesTotal": 99805,
                "headerNumber": 99805,
                "entitiesNumber": 99805,
                "overallThroughput": 171,
                "overallReadThroughput": 171
            },
            "exportUrls": [
                "https://idev-02.reltio.com/download.html?tenant=apanchenko123&downloadExportUrl=...",
                "https://idev-02.reltio.com/download.html?tenant=apanchenko123&downloadExportUrl=...",
                "https://idev-02.reltio.com/download.html?tenant=apanchenko123&downloadExportUrl=...",
                "https://idev-02.reltio.com/download.html?tenant=apanchenko123&downloadExportUrl=..."
            ],
            "statusId": 90,
            "numberOfObjects": 99805,
            "numberOfProcessedObjects": 99805,
            "warnings": "[]",
            "numberOfReadObjects": 99805,
            "status": "Completed"
        },
        "throughput": 85.669525,
        "duration": "19m 25s"
    }
]