Skip to main content
POST
/
v6
/
dimensions
/
values
/
query
Query dimension values
curl --request POST \
  --url https://sandbox.tight.com/v6/dimensions/values/query \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cursor": "<string>",
  "limit": 123
}
'
{
  "result": "SUCCESS",
  "data": [
    {
      "id": "cls_936413",
      "dimension": {
        "id": "tcll_439512",
        "rootId": "tcll_439512",
        "name": "Region",
        "requiredness": "REQUIRED"
      },
      "name": "Mid-Atlantic",
      "children": [
        {
          "id": "cls_936419",
          "dimension": {
            "id": "tcll_439513",
            "rootId": "tcll_439512",
            "name": "Location",
            "requiredness": "NOT_REQUIRED"
          },
          "name": "District of Columbia, DC",
          "children": [
            {
              "id": "cls_936415",
              "dimension": {
                "id": "tcll_439514",
                "rootId": "tcll_439512",
                "name": "Job Site",
                "requiredness": "NOT_REQUIRED"
              },
              "name": "1611 Connecticut Ave",
              "children": [],
              "label": {
                "id": "tcll_439514",
                "rootId": "tcll_439512",
                "name": "Job Site",
                "requiredness": "NOT_REQUIRED"
              }
            },
            {
              "id": "cls_936418",
              "dimension": {
                "id": "tcll_439514",
                "rootId": "tcll_439512",
                "name": "Job Site",
                "requiredness": "NOT_REQUIRED"
              },
              "name": "1815 Adams Mill Rd",
              "children": [],
              "label": {
                "id": "tcll_439514",
                "rootId": "tcll_439512",
                "name": "Job Site",
                "requiredness": "NOT_REQUIRED"
              }
            }
          ],
          "label": {
            "id": "tcll_439513",
            "rootId": "tcll_439512",
            "name": "Location",
            "requiredness": "NOT_REQUIRED"
          }
        },
        {
          "id": "cls_936420",
          "dimension": {
            "id": "tcll_439513",
            "rootId": "tcll_439512",
            "name": "Location",
            "requiredness": "NOT_REQUIRED"
          },
          "name": "Bethesda, MD",
          "children": [
            {
              "id": "cls_936416",
              "dimension": {
                "id": "tcll_439514",
                "rootId": "tcll_439512",
                "name": "Job Site",
                "requiredness": "NOT_REQUIRED"
              },
              "name": "5511 Cornish Rd",
              "children": [],
              "label": {
                "id": "tcll_439514",
                "rootId": "tcll_439512",
                "name": "Job Site",
                "requiredness": "NOT_REQUIRED"
              }
            }
          ],
          "label": {
            "id": "tcll_439513",
            "rootId": "tcll_439512",
            "name": "Location",
            "requiredness": "NOT_REQUIRED"
          }
        }
      ],
      "label": {
        "id": "tcll_439512",
        "rootId": "tcll_439512",
        "name": "Region",
        "requiredness": "REQUIRED"
      }
    },
    {
      "id": "cls_936414",
      "dimension": {
        "id": "tcll_439512",
        "rootId": "tcll_439512",
        "name": "Region",
        "requiredness": "REQUIRED"
      },
      "name": "Northeast",
      "children": [
        {
          "id": "cls_936421",
          "dimension": {
            "id": "tcll_439513",
            "rootId": "tcll_439512",
            "name": "Location",
            "requiredness": "NOT_REQUIRED"
          },
          "name": "Boston, MA",
          "children": [
            {
              "id": "cls_936417",
              "dimension": {
                "id": "tcll_439514",
                "rootId": "tcll_439512",
                "name": "Job Site",
                "requiredness": "NOT_REQUIRED"
              },
              "name": "123 Atlantic Avenue",
              "children": [],
              "label": {
                "id": "tcll_439514",
                "rootId": "tcll_439512",
                "name": "Job Site",
                "requiredness": "NOT_REQUIRED"
              }
            }
          ],
          "label": {
            "id": "tcll_439513",
            "rootId": "tcll_439512",
            "name": "Location",
            "requiredness": "NOT_REQUIRED"
          }
        }
      ],
      "label": {
        "id": "tcll_439512",
        "rootId": "tcll_439512",
        "name": "Region",
        "requiredness": "REQUIRED"
      }
    }
  ],
  "cursor": {
    "after": "<string>",
    "before": "<string>"
  },
  "error": []
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, see Authentication for more detail.

Body

application/json
cursor
string | null

Cursor from the previous paginated response

limit
integer<int32>

Page size, i.e. number of items to return per page

Required range: x <= 250

Response

Success

Paginated response for dimension values

result
enum<string>

Result status

Available options:
SUCCESS,
FAILURE
Example:

"SUCCESS"

data
object[]

List of dimension values

cursor
object

Cursor to be used in your subsequent paginated request. Only populated if there are more pages available.