Retrieve the items from a dimension that match one of a list of names or a list or codes.

This endpoint helps an integration resolve human-readable values, such as product names or employee codes, into the internal item identifiers needed for API operations.

Notes:

  • To use this call, you must be a Workspace Administrator.
  • This call does not return results for names or codes for which an item does not exist.
  • If the given workspace, model, or dimension do not exist, this call returns a 404 code.
  • If the dimension does not support codes and codes are provided, this call returns a 400 code.

Requests that support this feature

curl -X POST https://api.anaplan.com/2/0/workspaces/{workspaceId}/models/{modelId}/dimensions/{dimensionId}/items \
-H ‘Authorization: AnaplanAuthToken {anaplan_auth_token}' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' --data-raw '<see Request body>'

Method and endpoint

POST

/workspaces/{workspaceId}/models/{modelId}/dimensions/{dimensionId}/items

Parameters

ParameterDetails
{workspaceId}
  • Required in the supported request
  • Type: String
  • Description: The workspace ID
  • Example: 8a8196b15b7dbae6015b8694411d13fe
{modelId}
  • Required
  • Type: String
  • Description: the model ID
  • Example: 75A40874E6B64FA3AE074327899685
{dimensionId}
  • Required
  • Type: Number
  • Description: the dimension ID. This value must be the ID for any of these dimension types:
    • Lists
    • Time periods
    • Users
    • Versions
  • Example: 101000000001

Curl example

curl -X POST https://api.anaplan.com/2/0/workspaces/{workspaceId}/models/{modelId}/dimensions/{dimensionId}/items \
-H ‘Authorization: AnaplanAuthToken {anaplan_auth_token}' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' --data-raw '<see Request body>'

Response

Response 200 body

{
 "meta" : {
     "schema":"https://api.anaplan.com/2/0/objects/dimension"
 },
 "status" : {
   "code":200,
   "message":"Success"
 },
 "items":[
   {
     "name":"South",
     "id":"208000000001",
     "code":"S"
   },
   {
     "name":"West",
     "id":"208000000004",
     "code":"W"
   }
 ]
}