---
title: "List materials"
method: GET
path: "/v1/materials"
tags: ["DesignCatalog"]
---

# List materials

`GET /v1/materials`

## Query parameters

- `limit` integer
- `cursor` string
- `direction` 'after' | 'before'
- `ids` union
  - string[]
  - unknown
- `categories` union
  - string[]
  - unknown
- `includeArchived` boolean

## Response `200`

Materials retrieved successfully

- MaterialArrayApiResponseDto
  - `success` boolean, required — Indicates if the request was successful
  - `message` string, required — Human readable message
  - `data` object[], required — Array of data items
    - `id` string, uuid, required — Unique identifier of the material
    - `name` string, required — Name of the material
    - `thumbnailUrl` string, uri, required — URL of the material thumbnail
    - `textureUrl` string — URL of the material texture
    - `textureWidth` integer, required — Intrinsic texture width in pixels
    - `textureHeight` integer, required — Intrinsic texture height in pixels
    - `llmPrompt` string, nullable — Prompt used to describe material
    - `category` 'wood_flooring' | 'concrete' | 'tile' | 'fabric' | 'wood' | 'stone' | 'metal' | 'rug' | 'plant' | 'wood_paneling' | 'brick' | 'outdoor', required — Category of the material
    - `deletedAt` unknown
    - `createdAt` unknown, required
    - `updatedAt` unknown, required
  - `meta` object, required — Pagination metadata
    - `hasNext` boolean, required — Whether there are more items after current set
    - `hasPrevious` boolean, required — Whether there are items before current set
    - `nextCursor` string, nullable, required — Cursor for next page
    - `prevCursor` string, nullable, required — Cursor for previous page
  - `timestamp` string, date-time, required — Timestamp of the response

---

[API](https://skmtc.dev/maket/apis/virtual-architect-api.md) · [All operations](https://skmtc.dev/maket/apis/virtual-architect-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/maket/virtual-architect-api/revisions/b712097baa9c/schema)