---
title: "Route Schema Cube"
method: GET
path: "/complexity/cubes/{cube_name}"
tags: ["EconomicComplexityModule"]
---

# Route Schema Cube

`GET /complexity/cubes/{cube_name}`

## Request

- Base URL: `https://api.datausa.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.datausa.io/complexity/cubes/{cube_name}`
- Auth: none declared

Return the public schema for a single cube.

## Path parameters

- `cube_name` string, required

## Query parameters

- `locale` string, nullable
- `token` string, nullable

## Headers

- `authorization` string, nullable
- `x-tesseract-jwt` string, nullable

## Response `200`

Successful Response

- TesseractCube
  - `name` string, required
  - `caption` string, required
  - `annotations` object, required
  - `dimensions` TesseractDimension[], required
    - `name` string, required
    - `caption` string, required
    - `type` 'standard' | 'time' | 'geo', required: Kind of data a dimension is storing.
    - `annotations` object, required
    - `hierarchies` TesseractHierarchy[], required
      - `name` string, required
      - `caption` string, required
      - `annotations` object, required
      - `levels` TesseractLevel[], required
        - `name` string, required
        - `caption` string, required
        - `depth` integer, required
        - `count` integer, required
        - `scale` union, required
          - 'year' | 'quarter' | 'month' | 'week' | 'day': Specifies a scale of detail in time.
          - 'adm0' | 'adm1' | 'adm2': Specifies a scale of geographical administrative division.
        - `annotations` object, required
        - `properties` TesseractProperty[], required
          - `name` string, required
          - `caption` string, required
          - `type` 'bool' | 'date' | 'time' | 'dttm' | 'stmp' | 'f32' | 'f64' | 'i8' | 'i16' | 'i32' | 'i64' | 'i128' | 'u8' | 'u16' | 'u32' | 'u64' | 'u128' | 'str', required: Types of the data the user can expect to find in the associated column.
          - `annotations` object, required
    - `default_hierarchy` string, required
  - `measures` TesseractMeasure[], required
    - `name` string, required
    - `caption` string, required
    - `aggregator` string, required
    - `type` 'bool' | 'date' | 'time' | 'dttm' | 'stmp' | 'f32' | 'f64' | 'i8' | 'i16' | 'i32' | 'i64' | 'i128' | 'u8' | 'u16' | 'u32' | 'u64' | 'u128' | 'str', required: Types of the data the user can expect to find in the associated column.
    - `annotations` object, required
    - `attached` TesseractMeasure[], required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-27** `433b34956d9c`: 2 info
  - added the required property `dimensions/items/hierarchies/items/levels/items/scale` to the response with the `200` status
  - added the required property `measures/items/type` to the response with the `200` status

[Operation history](https://skmtc.dev/datausa/apis/datausa-api/changes/complexity/cubes/:cube_name/get.md)

---

[API](https://skmtc.dev/datausa/apis/datausa-api.md) - [All operations](https://skmtc.dev/datausa/apis/datausa-api/llms.txt) - [OpenAPI document](https://skmtc.dev/datausa/apis/datausa-api/revisions/433b34956d9c?raw)