List elements for a framework version

Prev Next
Get
/api/data/v1/frameworks/{frameworkId}/versions/{frameworkVersionId}/elements

Use this endpoint to retrieve the pricing elements (steps) that exist in a specific published framework version, along with the scope definitions that control how those elements vary across things like product, region, customer segment, and other scoping dimensions.

What you get back
A list of elements for the specified framework version. Each record includes metadata, such as an element ID, name, type, and scope data.

Security
HTTP
Type bearer

Enter an access token to authenticate your requests. For details, read Get an access token.

Path parameters
frameworkId
string (uuid) Required

Framework identifier.

frameworkVersionId
string (uuid) Required

Framework version identifier.

Responses
200

Elements of a framework version response

example
{
  "data": {
    "elements": [
      {
        "elementId": "33333333-3333",
        "displayName": "Base Price",
        "elementType": "PRICE",
        "stepType": "CALCULATED",
        "position": 1,
        "scopes": [
          {
            "elementScopeId": "44444444-4444",
            "name": "Default",
            "rank": 1,
            "isFallback": true,
            "scopingAttributes": [
              {
                "scopingAttributeId": "55555555-5555",
                "attributeName": "Product",
                "sourceEntityFieldId": "Product.ProductId"
              }
            ]
          }
        ]
      }
    ]
  },
  "meta": {
    "requestId": "req-123"
  }
}
Expand All
object
data
object
elements
Array of object (ElementRecord)

A list of framework version's elements.

object

A framework version's element and its key details like a unique ID, name, position, and related scopes.

pagination
object (Pagination)

Results pagination details.

cursor
string | null

Cursor for pagination.

hasMore
boolean

True if more records are available.

meta
object
requestId
string

Request identifier for tracing.

401

Unauthorized

unauthorized
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Unauthorized",
    "requestId": "req-123"
  }
}
Expand All
object
error
object (Error)
code
string
message
string
requestId
string
details
403

Forbidden

forbidden
{
  "error": {
    "code": "FORBIDDEN",
    "message": "Forbidden",
    "requestId": "req-123"
  }
}
Expand All
object
error
object (Error)
code
string
message
string
requestId
string
details
404

Queried element not found

notFound
{
  "error": {
    "code": "NOT_FOUND",
    "message": "Not found",
    "requestId": "req-123"
  }
}
Expand All
object
error
object (Error)
code
string
message
string
requestId
string
details
500

Internal error

internalError
{
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Internal error",
    "requestId": "req-123"
  }
}
Expand All
object
error
object (Error)
code
string
message
string
requestId
string
details
502

Upstream error

upstreamError
{
  "error": {
    "code": "UPSTREAM_ERROR",
    "message": "Upstream dependency failed",
    "requestId": "req-123"
  }
}
Expand All
object
error
object (Error)
code
string
message
string
requestId
string
details