Skip to main content

Retrieve data model parameters

Available since Strategy (May 2026)

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)