---
title: "Get Parsed Geometry"
method: POST
path: "/v1/visualizations/parse-file"
tags: ["visualization"]
---

# Get Parsed Geometry

`POST /v1/visualizations/parse-file`

## Request

- Base URL: `https://api.shapemaker.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.shapemaker.io/v1/visualizations/parse-file`
- Auth: OAuth 2
  - Password
  - Token URL: `/v1/auth`

## Request body

- CreateStructureFromFileInput
  - `name` string
  - `content` string
  - `fileType` 'MS_TOWER_ARC_EXPORT' | 'DLUBAL_PYTHON_SCRIPT' | 'ERI_TNX', required
  - `structureType` 'tower' | 'guyed_mast' | 'monopole' | 'rooftop' | 'hybrid' | 'mount' | 'unknown', required
  - `tags` string[], nullable
  - `sectionHeights` number[], nullable

## Response `200`

Successful Response

- VisualizeView
  - `structure` RenderableMember[], required
    - `shapes` RenderableShape3D[], required
      - `type` 'box' | 'pipe' | 'prism' | 'cylinder' | 'tapered_cylinder', required
      - `geometry` union, required
        - BoxDimension
          - `height` number, required
          - `width` number, required
          - `depth` number, required
        - CylinderDimension
          - `length` number, required
          - `diameter` number, required
        - PolylineDimension
          - `points` Point[], required
            - `x` number, required
            - `y` number, required
            - `z` number, required
            - `point_number` integer
          - `is_closed` boolean, required
        - TaperedCylinderDimension
          - `length` number, required
          - `diameter_bottom` number, required
          - `diameter_top` number, required
          - `sides` integer, required
        - NoDimension
      - `matrix` number[], required
      - `material` Material, required
        - `color` string, required
        - `opacity` number
        - `roughness` number
        - `metalness` number
    - `member_type` 'Leg1' | 'Diagonal1' | 'Diagonal2' | 'Horizontal1' | 'Horizontal2' | 'Secondary1' | 'Secondary2' | 'Secondary3' | 'Secondary4' | 'Hip1' | 'Hip2' | 'Hip3' | 'Hip4' | 'Plan1' | 'Plan2' | 'Plan3' | 'Plan4' | 'GuyWire' | 'MonopoleLeg' | 'RigidArm' | 'SingleLeg' | 'RooftopBeam' | 'MountMember', required
    - `panel_index` integer, nullable
    - `section_name` string, nullable
    - `steel_grade` string, nullable
    - `orientation_deg` number, nullable
    - `bottom_elevation_m` number, nullable
    - `top_elevation_m` number, nullable
    - `length_m` number, nullable
  - `ancillaries` RenderableAncillary[], required
    - `shapes` union[], required
      - union
        - RenderableShape3D
          - `type` 'box' | 'pipe' | 'prism' | 'cylinder' | 'tapered_cylinder', required
          - `geometry` union, required
            - BoxDimension
              - …
            - CylinderDimension
              - …
            - PolylineDimension
              - …
            - TaperedCylinderDimension
              - …
            - NoDimension
          - `matrix` number[], required
          - `material` Material, required
            - `color` string, required
            - `opacity` number
            - `roughness` number
            - `metalness` number
        - RenderableShape2D
          - `type` 'line' | 'face'
          - `geometry` LineDimension, required
            - `start` Point, required
              - …
            - `end` Point, required
              - …
            - `width` number, required
            - `color` string
          - `style` 'solid' | 'dashed' | 'dotted' | 'dash-dot', required
          - `metadata` object, nullable
        - RenderableText
          - `type` 'text'
          - `position` Point, required
            - `x` number, required
            - `y` number, required
            - `z` number, required
            - `point_number` integer
          - `content` string, required
          - `size` number, required
          - `orientation` number
          - `props` object
        - Renderable3DModel
          - `type` 'object_3d'
          - `model` 'Paraboloid_1x1.glb' | 'North_label.glb' | 'Soil_geometry.glb' | 'Error_arrow.glb', required
          - `material` Material, required
            - `color` string, required
            - `opacity` number
            - `roughness` number
            - `metalness` number
          - `matrix` number[], required
    - `tenant_name` string, required
    - `id` integer, nullable: id of the ancillary for selection purposes
  - `foundation` RenderableShape3D[], required
    - `type` 'box' | 'pipe' | 'prism' | 'cylinder' | 'tapered_cylinder', required
    - `geometry` union, required
      - BoxDimension
        - `height` number, required
        - `width` number, required
        - `depth` number, required
      - CylinderDimension
        - `length` number, required
        - `diameter` number, required
      - PolylineDimension
        - `points` Point[], required
          - `x` number, required
          - `y` number, required
          - `z` number, required
          - `point_number` integer
        - `is_closed` boolean, required
      - TaperedCylinderDimension
        - `length` number, required
        - `diameter_bottom` number, required
        - `diameter_top` number, required
        - `sides` integer, required
      - NoDimension
    - `matrix` number[], required
    - `material` Material, required
      - `color` string, required
      - `opacity` number
      - `roughness` number
      - `metalness` number
  - `feeders` RenderableShape3D[], required
    - `type` 'box' | 'pipe' | 'prism' | 'cylinder' | 'tapered_cylinder', required
    - `geometry` union, required
      - BoxDimension
        - `height` number, required
        - `width` number, required
        - `depth` number, required
      - CylinderDimension
        - `length` number, required
        - `diameter` number, required
      - PolylineDimension
        - `points` Point[], required
          - `x` number, required
          - `y` number, required
          - `z` number, required
          - `point_number` integer
        - `is_closed` boolean, required
      - TaperedCylinderDimension
        - `length` number, required
        - `diameter_bottom` number, required
        - `diameter_top` number, required
        - `sides` integer, required
      - NoDimension
    - `matrix` number[], required
    - `material` Material, required
      - `color` string, required
      - `opacity` number
      - `roughness` number
      - `metalness` number
  - `linear_ancillaries` RenderableLinearAncillary[]
    - `key` string, required
    - `parent_key` string, nullable
    - `shapes` RenderableShape3D[], required
      - `type` 'box' | 'pipe' | 'prism' | 'cylinder' | 'tapered_cylinder', required
      - `geometry` union, required
        - BoxDimension
          - `height` number, required
          - `width` number, required
          - `depth` number, required
        - CylinderDimension
          - `length` number, required
          - `diameter` number, required
        - PolylineDimension
          - `points` Point[], required
            - `x` number, required
            - `y` number, required
            - `z` number, required
            - `point_number` integer
          - `is_closed` boolean, required
        - TaperedCylinderDimension
          - `length` number, required
          - `diameter_bottom` number, required
          - `diameter_top` number, required
          - `sides` integer, required
        - NoDimension
      - `matrix` number[], required
      - `material` Material, required
        - `color` string, required
        - `opacity` number
        - `roughness` number
        - `metalness` number
    - `steel` boolean
    - `tenant_name` string, nullable
    - `is_route` boolean
  - `tower_height` number, required
  - `attachments` union[], required
    - union
      - RenderableShape3D
        - `type` 'box' | 'pipe' | 'prism' | 'cylinder' | 'tapered_cylinder', required
        - `geometry` union, required
          - BoxDimension
            - `height` number, required
            - `width` number, required
            - `depth` number, required
          - CylinderDimension
            - `length` number, required
            - `diameter` number, required
          - PolylineDimension
            - `points` Point[], required
              - …
            - `is_closed` boolean, required
          - TaperedCylinderDimension
            - `length` number, required
            - `diameter_bottom` number, required
            - `diameter_top` number, required
            - `sides` integer, required
          - NoDimension
        - `matrix` number[], required
        - `material` Material, required
          - `color` string, required
          - `opacity` number
          - `roughness` number
          - `metalness` number
      - RenderableShape2D
        - `type` 'line' | 'face'
        - `geometry` LineDimension, required
          - `start` Point, required
            - `x` number, required
            - `y` number, required
            - `z` number, required
            - `point_number` integer
          - `end` Point, required
            - `x` number, required
            - `y` number, required
            - `z` number, required
            - `point_number` integer
          - `width` number, required
          - `color` string
        - `style` 'solid' | 'dashed' | 'dotted' | 'dash-dot', required
        - `metadata` object, nullable
      - RenderableText
        - `type` 'text'
        - `position` Point, required
          - `x` number, required
          - `y` number, required
          - `z` number, required
          - `point_number` integer
        - `content` string, required
        - `size` number, required
        - `orientation` number
        - `props` object
      - Renderable3DModel
        - `type` 'object_3d'
        - `model` 'Paraboloid_1x1.glb' | 'North_label.glb' | 'Soil_geometry.glb' | 'Error_arrow.glb', required
        - `material` Material, required
          - `color` string, required
          - `opacity` number
          - `roughness` number
          - `metalness` number
        - `matrix` number[], required
  - `collisions` union[]
    - union
      - RenderableShape3D
        - `type` 'box' | 'pipe' | 'prism' | 'cylinder' | 'tapered_cylinder', required
        - `geometry` union, required
          - BoxDimension
            - `height` number, required
            - `width` number, required
            - `depth` number, required
          - CylinderDimension
            - `length` number, required
            - `diameter` number, required
          - PolylineDimension
            - `points` Point[], required
              - …
            - `is_closed` boolean, required
          - TaperedCylinderDimension
            - `length` number, required
            - `diameter_bottom` number, required
            - `diameter_top` number, required
            - `sides` integer, required
          - NoDimension
        - `matrix` number[], required
        - `material` Material, required
          - `color` string, required
          - `opacity` number
          - `roughness` number
          - `metalness` number
      - RenderableShape2D
        - `type` 'line' | 'face'
        - `geometry` LineDimension, required
          - `start` Point, required
            - `x` number, required
            - `y` number, required
            - `z` number, required
            - `point_number` integer
          - `end` Point, required
            - `x` number, required
            - `y` number, required
            - `z` number, required
            - `point_number` integer
          - `width` number, required
          - `color` string
        - `style` 'solid' | 'dashed' | 'dotted' | 'dash-dot', required
        - `metadata` object, nullable
      - RenderableText
        - `type` 'text'
        - `position` Point, required
          - `x` number, required
          - `y` number, required
          - `z` number, required
          - `point_number` integer
        - `content` string, required
        - `size` number, required
        - `orientation` number
        - `props` object
      - Renderable3DModel
        - `type` 'object_3d'
        - `model` 'Paraboloid_1x1.glb' | 'North_label.glb' | 'Soil_geometry.glb' | 'Error_arrow.glb', required
        - `material` Material, required
          - `color` string, required
          - `opacity` number
          - `roughness` number
          - `metalness` number
        - `matrix` number[], required
  - `connections` RenderableShape3D[]
    - `type` 'box' | 'pipe' | 'prism' | 'cylinder' | 'tapered_cylinder', required
    - `geometry` union, required
      - BoxDimension
        - `height` number, required
        - `width` number, required
        - `depth` number, required
      - CylinderDimension
        - `length` number, required
        - `diameter` number, required
      - PolylineDimension
        - `points` Point[], required
          - `x` number, required
          - `y` number, required
          - `z` number, required
          - `point_number` integer
        - `is_closed` boolean, required
      - TaperedCylinderDimension
        - `length` number, required
        - `diameter_bottom` number, required
        - `diameter_top` number, required
        - `sides` integer, required
      - NoDimension
    - `matrix` number[], required
    - `material` Material, required
      - `color` string, required
      - `opacity` number
      - `roughness` number
      - `metalness` number
  - `shelters` RenderableShelter[]
    - `id` integer, required
    - `name` string, required
    - `x_m` number, required
    - `y_m` number, required
    - `rotation_deg` number, required
    - `is_position_manual` boolean, required
    - `shapes` RenderableShape3D[], required
      - `type` 'box' | 'pipe' | 'prism' | 'cylinder' | 'tapered_cylinder', required
      - `geometry` union, required
        - BoxDimension
          - `height` number, required
          - `width` number, required
          - `depth` number, required
        - CylinderDimension
          - `length` number, required
          - `diameter` number, required
        - PolylineDimension
          - `points` Point[], required
            - `x` number, required
            - `y` number, required
            - `z` number, required
            - `point_number` integer
          - `is_closed` boolean, required
        - TaperedCylinderDimension
          - `length` number, required
          - `diameter_bottom` number, required
          - `diameter_top` number, required
          - `sides` integer, required
        - NoDimension
      - `matrix` number[], required
      - `material` Material, required
        - `color` string, required
        - `opacity` number
        - `roughness` number
        - `metalness` number
    - `contents` RenderableAncillary[], required
      - `shapes` union[], required
        - union
          - RenderableShape3D
            - `type` 'box' | 'pipe' | 'prism' | 'cylinder' | 'tapered_cylinder', required
            - `geometry` union, required
              - …
            - `matrix` number[], required
            - `material` Material, required
              - …
          - RenderableShape2D
            - `type` 'line' | 'face'
            - `geometry` LineDimension, required
              - …
            - `style` 'solid' | 'dashed' | 'dotted' | 'dash-dot', required
            - `metadata` object, nullable
          - RenderableText
            - `type` 'text'
            - `position` Point, required
              - …
            - `content` string, required
            - `size` number, required
            - `orientation` number
            - `props` object
          - Renderable3DModel
            - `type` 'object_3d'
            - `model` 'Paraboloid_1x1.glb' | 'North_label.glb' | 'Soil_geometry.glb' | 'Error_arrow.glb', required
            - `material` Material, required
              - …
            - `matrix` number[], required
      - `tenant_name` string, required
      - `id` integer, nullable: id of the ancillary for selection purposes

## Other responses

- `422`: Validation Error

---

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