> For the complete documentation index, see [llms.txt](https://docs.simplio3d.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.simplio3d.com/api-reference/open-api/textures/texture-categories.md).

# Texture Categories

## <mark style="color:green;">GET</mark> /textures-categories/list

#### Endpoint: Retrieve All Texture Categories

**HTTP Method:** `GET`

**URL:** `/open-api/v1/textures-categories/list`

**Description:** This endpoint retrieves a list of all texture categories available in the database **without applying pagination filters**. It returns a detailed list ensuring all categories are accessible in a single response.

**Response Format:**

* **Status Code:** `200 OK`
* **Content-Type:** `application/json`

**Response Example:**

```json
[
    {
        "id": "1",
        "name": "Wood"
    },
    {
        "id": "2",
        "name": "Metal"
    },
    {
        "id": "3",
        "name": "Stone"
    }
    // ... more categories
]
```

**Notes:**

* Ensure proper authorization headers are included if necessary.
* The response will include all categories, so handle large datasets appropriately in your application.

## Retrieve all texture categories without pagination

> Get all texture categories without pagination.

```json
{"openapi":"3.0.0","info":{"title":"Simplio3D-Open REST API","version":"1.0.0"},"tags":[{"name":"Textures Categories","description":"API Endpoints for managing textures categories"}],"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":{"TexturesCategoriesResource":{"title":"Textures Categories Resource","description":"Textures category data","properties":{"id":{"type":"integer"},"title":{"type":"string"},"description":{"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/textures-categories/list":{"get":{"tags":["Textures Categories"],"summary":"Retrieve all texture categories without pagination","description":"Get all texture categories without pagination.","operationId":"fd9aac44d78db7d908bb05a8a968a93a","parameters":[{"name":"order_by","in":"query","description":"Column to order results by (e.g., 'created_at')","required":false,"schema":{"type":"string"}},{"name":"order","in":"query","description":"Sorting order (asc or desc)","required":false,"schema":{"type":"string","enum":["asc","desc"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TexturesCategoriesResource"}}}}},"401":{"description":"Unauthorized"},"500":{"description":"Internal server error"}}}}}}
```

## <mark style="color:green;">GET</mark> /textures-categories/{id}

#### Get Texture Category by ID - GET Endpoint

**Endpoint:**

```
GET open-api/v1/textures-categories/{id}
```

**Description:**

Retrieve detailed information about a specific texture category using its unique ID.

**Authorization:**

Ensure appropriate authorization headers are included in the request.

**Parameters:**

* **id** (path parameter) - The unique identifier of the texture category.

**Response:**

Returns a JSON object containing detailed information about the texture category, such as its name, description, and any related metadata.

**Example Response:**

```json
{
    "id": "2",
    "name": "Metal",
    "description": "A category for all metal-based textures."
}
```

**Notes:**

* Handle any potential errors such as `404 Not Found` for invalid IDs.
* Consider rate limits and implement retry logic as appropriate.

## Get texture category by ID

> Get a specific texture category by ID.

```json
{"openapi":"3.0.0","info":{"title":"Simplio3D-Open REST API","version":"1.0.0"},"tags":[{"name":"Textures Categories","description":"API Endpoints for managing textures categories"}],"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":{"TexturesCategoriesResource":{"title":"Textures Categories Resource","description":"Textures category data","properties":{"id":{"type":"integer"},"title":{"type":"string"},"description":{"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/textures-categories/{id}":{"get":{"tags":["Textures Categories"],"summary":"Get texture category by ID","description":"Get a specific texture category by ID.","operationId":"8b5635edf89f4fc6e0a4d81bc7c11c29","parameters":[{"name":"id","in":"path","description":"ID of the texture category","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TexturesCategoriesResource"}}}},"401":{"description":"Unauthorized"},"404":{"description":"Texture category not found"}}}}}}
```

## <mark style="color:green;">GET</mark> /textures-categories

#### Get List of Texture Categories

The **Get List of Texture Categories** endpoint retrieves a complete list of available texture categories. Each category includes essential details such as the category's ID, name, and description.

**Endpoint**

```
GET /open-api/v1/textures-categories
```

**Example Request**

```http
GET /open-api/v1/texture-categories HTTP/1.1
Host: api.simplio3d.com
Authorization: Bearer YOUR_ACCESS_TOKEN
```

**Example Response**

```json
[
    {
        "id": "1",
        "name": "Wood",
        "description": "A category for all wood-based textures."
    },
    {
        "id": "2",
        "name": "Metal",
        "description": "A category for all metal-based textures."
    }
]
```

**Notes**

* Ensure a valid access token is provided in the request header.
* Handle potential errors, such as `401 Unauthorized` if the token is invalid or expired.
* Implement retry logic to handle rate limit errors if encountered.

## Get list of textures categories

> Get all textures categories.

```json
{"openapi":"3.0.0","info":{"title":"Simplio3D-Open REST API","version":"1.0.0"},"tags":[{"name":"Textures Categories","description":"API Endpoints for managing textures categories"}],"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>)"}}},"paths":{"/api/open-api/v1/textures-categories":{"get":{"tags":["Textures Categories"],"summary":"Get list of textures categories","description":"Get all textures categories.","operationId":"17c8efb40642d28b9ed1f52bf7978bca","parameters":[{"name":"per_page","in":"query","description":"Number of records per page (-1 for all records)","schema":{"type":"integer"}},{"name":"page","in":"query","description":"Number of page","required":false,"schema":{"type":"integer"}},{"name":"order_by","in":"query","description":"Column to sort by","schema":{"type":"string"}},{"name":"order","in":"query","description":"Sort order (asc/desc)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}}}}}}
```