Retrieve Data Load
get
[host-url]/dt-rest/v2/dataloads/{dataLoadId}
Retrieves the specified data load.
Request
Path Parameters
-
dataLoadId(required): string
the ID of the data load to retrieve
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
200 Response
a response containing the specified data load
Root Schema : DataLoadDTO
Match All
Represents a detailed data load object, extending DataLoadBaseDTO.
Show Source
-
object
DataLoadBaseDTO
Represents a base data load object, containing minimal attributes for data load operations.
-
object
DataLoadDTO-allOf[1]
Represents a detailed data load object, extending DataLoadBaseDTO.
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:
objectRepresents a base data load object, containing minimal attributes for data load operations.
Show Source
-
dataLoadId: string
-
dataLoadMode: string
Allowed Values:
[ "INITIAL", "INCREMENTAL", "GOLDENGATE", "DELTASHARE", "ICEBERG_TARGET", "ICEBERG_INCREMENTAL" ]Enumerates the possible modes for data load operations.- Initial: Loads all data for the first time.
- Incremental: Loads only new or changed data since the last load.
- Golden Gate: Uses Oracle GoldenGate for real-time data integration.
- Delta Share: Loads data via a Delta Sharing protocol.
- Iceberg target: Loads data directly into an Apache Iceberg table (target).
- Iceberg incremental: Loads only incremental changes into an Apache Iceberg table.
-
dataLoadNumber: integer
(int64)
-
dateCreated: string
(date-time)
-
dateUpdated: string
(date-time)
-
description: string
-
name(required): string
-
projectID: string
-
projectName: string
Nested Schema : DataLoadDTO-allOf[1]
Type:
objectRepresents a detailed data load object, extending DataLoadBaseDTO.
Show Source
-
dataLoadOptions: object
DataLoadOptionsDTO
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.
-
sourceSchema: object
DataLoadSchemaDTO
Represents a data load schema.
-
targetSchema: object
DataLoadSchemaDTO
Represents a data load schema.
-
validationMessages: array
validationMessages
Nested Schema : DataLoadOptionsDTO
Type:
objectExposes per-run configuration flags used by data load REST endpoints.
Show Source
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.
-
auditing: object
auditing
Additional Properties Allowed: DTAuditField
-
biccExecutionMode: string
-
kmOptions: object
kmOptions
Additional Properties Allowed: additionalProperties
-
kmOptions_RERUN: object
kmOptions_RERUN
Additional Properties Allowed: additionalProperties
-
liveTablesList: array
liveTablesList
-
liveTablesMap: object
liveTablesMap
Additional Properties Allowed: additionalProperties
-
namingConvention: string
-
offerings: array
offerings
-
reservedWords: string
-
tablesToDeleteInTGT: array
tablesToDeleteInTGT
Nested Schema : additionalProperties
Type:
Show Source
array-
Array of:
object DTKMOption
Represents Knowledge Module Options in Data Transforms.
Nested Schema : DTKMOption
Type:
objectRepresents Knowledge Module Options in Data Transforms.
Show Source
Nested Schema : additionalProperties
Type:
Show Source
array-
Array of:
object DTKMOption
Represents Knowledge Module Options in Data Transforms.
Examples
401 Response
Unauthorized
403 Response
Forbidden
404 Response
Not Found
409 Response
Conflict