Retrieve data model parameters
This workflow sample demonstrates how to retrieve all parameters that belong to a data model using the REST API. Parameters are value prompts tracked in the data model report definition's parameters collection.
info
Get the authorization token needed to execute the request with POST /api/auth/login.
Get the project ID from GET /api/projects.
tip
Changesets are used in this workflow. For information on how to create and use changesets, see Changesets.
Endpoint: GET /api/model/dataModels/{dataModelId}/parameters
Sample Request
- Request Headers
'Content-Type: application/json'
'Accept: application/json'
'X-MSTR-AuthToken: pk2dudliaoqh5hmv240ururl82'
'X-MSTR-ProjectID: B7CA92F04B9FAE8D941C3E9B7E0CD754'
- Curl
curl -L -X GET 'http://demo.microstrategy.com/MicroStrategyLibrary/api/model/dataModels/3A82F20B2CC849B0970B289C86D8C83C/parameters' \
-H 'X-MSTR-AuthToken: pk2dudliaoqh5hmv240ururl82' \
-H 'X-MSTR-ProjectID: B7CA92F04B9FAE8D941C3E9B7E0CD754'
Sample Response
- Response Body:
{
"offset": 0,
"limit": -1,
"total": 2,
"parameters": [
{
"information": {
"dateCreated": "2026-08-27T08:51:50.958Z",
"dateModified": "2026-08-27T08:51:50.958Z",
"versionId": "C47943524FCA63A86BCDBF99EFE3424C",
"acg": 255,
"primaryLocale": "en-US",
"objectId": "E6CD1AA47E5A4DB7B23EDAA6FBC07578",
"subType": "prompt_double",
"name": "Region Range Prompt",
"destinationFolderId": "FB63EDEB81474D2DB675CA7E865F814E"
},
"defaultAnswer": {
"value": 202005.0
},
"restriction": {
"min": 202001.0,
"max": 202512.0,
"interval": 1.0,
"allowedValueType": "range"
}
},
{
"information": {
"dateCreated": "2026-08-27T08:51:50.958Z",
"dateModified": "2026-08-27T08:51:50.958Z",
"versionId": "C47943524FCA63A86BCDBF99EFE3424C",
"acg": 255,
"primaryLocale": "en-US",
"objectId": "2A1C9F3C8F0B4E6D8A7B5C2D3E4F5A6B",
"subType": "prompt_date",
"name": "Date Range Prompt",
"destinationFolderId": "FB63EDEB81474D2DB675CA7E865F814E"
},
"defaultAnswer": {
"value": {
"parameterType": "dynamic_date_time",
"dynamicDateTime": {
"type": "date",
"date": {
"mode": "static",
"value": "2026-08-15"
}
}
}
},
"restriction": {
"min": {
"parameterType": "dynamic_date_time",
"dynamicDateTime": {
"type": "date",
"date": {
"mode": "static",
"value": "2026-08-01"
}
}
},
"max": {
"parameterType": "dynamic_date_time",
"dynamicDateTime": {
"type": "date",
"date": {
"mode": "static",
"value": "2026-08-20"
}
}
},
"allowedValueType": "range"
},
"showTime": false
}
]
}
- Response Code: 200 (Success: OK)