Retrieve Data Load

get

[host-url]/dt-rest/v2/dataloads/{dataLoadId}

Retrieves the specified data load.

Request

Path Parameters

There's no request body for this operation.

Back to Top

Response

Supported Media Types

200 Response

a response containing the specified data load
Body ()
Root Schema : DataLoadDTO
Match All
Represents a detailed data load object, extending DataLoadBaseDTO.
Show Source
Example:
{
    "dataLoadNumber":123,
    "dataLoadId":"String",
    "name":"String",
    "description":"String",
    "projectId":"String",
    "projectName":"String",
    "dateCreated":"2026-07-11T17:31:42.998971Z",
    "dateUpdated":"2026-07-11T17:31:42.998991Z",
    "dataLoadMode":"INITIAL",
    "sourceSchema":{
        "schemaId":"String",
        "shortName":"String",
        "parentConnection":"String"
    },
    "targetSchema":{
        "schemaId":"String",
        "shortName":"String",
        "parentConnection":"String"
    },
    "dataLoadOptions":{
        "namingConvention":"String",
        "reservedWords":"String",
        "liveTablesList":[
            "String"
        ],
        "liveTablesMap":{
            "key":[
                "String"
            ]
        },
        "biccExecutionMode":"String",
        "kmOptions":{
            "key":[
                {
                    "optionName":"String",
                    "optionValue":"String",
                    "optionType":"String",
                    "setAsDefault":true,
                    "description":"String",
                    "help":"String",
                    "defaultValue":"String",
                    "choiceValues":[
                        "String"
                    ]
                }
            ]
        },
        "kmOptions_RERUN":{
            "key":[
                {
                    "optionName":"String",
                    "optionValue":"String",
                    "optionType":"String",
                    "setAsDefault":true,
                    "description":"String",
                    "help":"String",
                    "defaultValue":"String",
                    "choiceValues":[
                        "String"
                    ]
                }
            ]
        },
        "offerings":[
            "String"
        ],
        "auditing":{
            "key":{
                "enabled":true,
                "description":"String"
            }
        },
        "tablesToDeleteInTGT":[
            "String"
        ]
    },
    "validationMessages":[
        "String"
    ]
}
Nested Schema : DataLoadBaseDTO
Type: object
Represents a base data load object, containing minimal attributes for data load operations.
Show Source
Nested Schema : DataLoadDTO-allOf[1]
Type: object
Represents a detailed data load object, extending DataLoadBaseDTO.
Show Source
Nested Schema : DataLoadOptionsDTO
Type: object
Exposes per-run configuration flags used by data load REST endpoints.

Every property corresponds to a JSON field expected when configuring a data load request, covering naming conventions, live table selection, Knowledge Module (KM) overrides, and audit metadata.

Show Source
Nested Schema : DataLoadSchemaDTO
Type: object
Represents a data load schema.
Show Source
Nested Schema : validationMessages
Type: array
Show Source
Nested Schema : auditing
Type: object
Additional Properties Allowed
Show Source
Nested Schema : kmOptions
Type: object
Additional Properties Allowed
Show Source
Nested Schema : kmOptions_RERUN
Type: object
Additional Properties Allowed
Show Source
Nested Schema : liveTablesList
Type: array
Show Source
Nested Schema : liveTablesMap
Type: object
Additional Properties Allowed
Show Source
Nested Schema : offerings
Type: array
Show Source
Nested Schema : tablesToDeleteInTGT
Type: array
Show Source
Nested Schema : DTAuditField
Type: object
Show Source
Nested Schema : additionalProperties
Type: array
Show Source
Nested Schema : DTKMOption
Type: object
Represents Knowledge Module Options in Data Transforms.
Show Source
Nested Schema : choiceValues
Type: array
Show Source
Nested Schema : additionalProperties
Type: array
Show Source
Nested Schema : additionalProperties
Type: array
Show Source
Examples

401 Response

Unauthorized

403 Response

Forbidden

404 Response

Not Found

409 Response

Conflict
Back to Top