# 3D Assets

### <mark style="color:green;">GET</mark> /configurator-assets-models

#### Description

Retrieves a list of configurator asset models. Each model represents the configuration details of a specific asset.

#### URL

`GET /configurator-assets-models`

#### Query Parameters

* **page** (optional): The page number of results to retrieve.
* **limit** (optional): The number of results per page.
* **sort** (optional): The field by which to sort the results.

#### Response

* **200 OK**: A successful response will return a JSON object containing:

  * **models**: An array of configurator asset models.
  * **total**: The total number of available models.
  * **page**: The current page number.
  * **limit**: The number of results per page as requested.

  #### Example Request

  ```http
  GET /configurator-assets-models?page=1&limit=10&sort=name
  ```

  #### Example Response

  ```json
  {
    "models": [
      {
        "id": "123",
        "name": "Model A",
        "description": "Description of Model A"
      },
      {
        "id": "124",
        "name": "Model B",
        "description": "Description of Model B"
      }
    ],
    "total": 25,
    "page": 1,
    "limit": 10
  }
  ```

  #### Error Responses

  * **400 Bad Request**: Invalid request parameters.
  * **500 Internal Server Error**: A server error occurred while processing the request.

**NOTE:** Ensure you have the necessary authorization credentials (e.g., Bearer Token) to access this endpoint which is taken from the 'Share' tab encryption token found at the bottom of the page.

## Fetch all configurator 3D asset models

> Get a list of configurator 3D asset models.

```json
{"openapi":"3.0.0","info":{"title":"Simplio3D-Open REST API","version":"1.0.0"},"tags":[{"name":"Configurator 3D Asset Models","description":"API Endpoints for managing configurator 3D asset models"}],"servers":[{"url":"https://app.simplio3d.com","description":"API Open Base URL"},{"url":""}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Enter token in format (Bearer <your_token>)"}},"schemas":{"ConfiguratorAssetsModelsResource":{"title":"Configurator 3D Asset Models Resource","description":"Schema for configurator 3D asset models","properties":{"id":{"type":"integer"},"name":{"type":"string"},"models_url":{"type":"string","format":"url"},"preview_models_url":{"type":"string","format":"url"},"models_orientation":{"type":"string"},"meshes_list":{"type":"array","items":{"type":"string"}},"category_id":{"type":"integer"},"status":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"created_by":{"type":"string"}},"type":"object"}}},"paths":{"/api/open-api/v1/configurator-assets-models":{"get":{"tags":["Configurator 3D Asset Models"],"summary":"Fetch all configurator 3D asset models","description":"Get a list of configurator 3D asset models.","operationId":"1060d0990e589367525ee0d343f607d5","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ConfiguratorAssetsModelsResource"}}},"type":"object"}}}},"400":{"description":"Invalid request parameters"},"401":{"description":"Unauthorized"},"404":{"description":"Configurator not found"},"500":{"description":"Internal Server Error"}}}}}}
```

## The ConfiguratorAssetsModelsResource object

```json
{"openapi":"3.0.0","info":{"title":"Simplio3D-Open REST API","version":"1.0.0"},"components":{"schemas":{"ConfiguratorAssetsModelsResource":{"title":"Configurator 3D Asset Models Resource","description":"Schema for configurator 3D asset models","properties":{"id":{"type":"integer"},"name":{"type":"string"},"models_url":{"type":"string","format":"url"},"preview_models_url":{"type":"string","format":"url"},"models_orientation":{"type":"string"},"meshes_list":{"type":"array","items":{"type":"string"}},"category_id":{"type":"integer"},"status":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"created_by":{"type":"string"}},"type":"object"}}}}
```

## The AssetsModelsResource object

```json
{"openapi":"3.0.0","info":{"title":"Simplio3D-Open REST API","version":"1.0.0"},"components":{"schemas":{"AssetsModelsResource":{"title":"Assets Models Resource","description":"3D Asset Model Resource","properties":{"id":{"description":"Unique identifier of the asset model","type":"integer"},"name":{"description":"Name of the asset model","type":"string"},"models_url":{"description":"URL to the original 3D model file","type":"string","format":"url"},"preview_models_url":{"description":"URL to the preview version of the 3D model","type":"string","format":"url"},"models_orientation":{"description":"Orientation data for the 3D model","type":"string"},"meshes_list":{"description":"List of meshes included in the 3D model","type":"array","items":{"type":"string"}},"category_id":{"description":"Category ID to which the asset model belongs","type":"integer"},"status":{"description":"Current status of the asset model","type":"string"},"created_at":{"description":"Timestamp when the model was created","type":"string","format":"date-time"},"updated_at":{"description":"Timestamp when the model was last updated","type":"string","format":"date-time"},"created_by":{"description":"Full name of the creator of the model","type":"string"}},"type":"object"}}}}
```