# 3D Assets
### GET /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 )"}},"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"}}}}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.simplio3d.com/api-reference/open-api/3d-assets.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.