### Get Asset Files

Source: https://api.polyhaven.com/api-docs/swagger

Retrieves a list of all available files for a specific asset, organized by resolution and format.

```APIDOC
## GET /files/{id}

### Description
Provides a structured list of all available files for a given asset, including different resolutions and formats.

### Method
GET

### Endpoint
/files/{id}

### Parameters
#### Path Parameters
- **id** (string) - Required - The unique ID or slug of the asset (e.g., `ceramic_vase_03`).

### Request Example
```
GET /files/ceramic_vase_03
```

### Response
#### Success Response (200)
- **files_list** (object) - A JSON object representing the file structure for the asset.

#### Response Example
```json
{
  "id": "ceramic_vase_03",
  "name": "Ceramic Vase 03",
  "type": "models",
  "files": {
    "1k": {
      "obj": "https://dl.polyhaven.org/file/ph-assets/Models/1K/ceramic_vase_03.obj",
      "mtl": "https://dl.polyhaven.org/file/ph-assets/Models/1K/ceramic_vase_03.mtl"
    },
    "2k": {
      "obj": "https://dl.polyhaven.org/file/ph-assets/Models/2K/ceramic_vase_03.obj",
      "mtl": "https://dl.polyhaven.org/file/ph-assets/Models/2K/ceramic_vase_03.mtl"
    }
  }
}
```
```

--------------------------------

### Get Asset Information

Source: https://api.polyhaven.com/api-docs/swagger

Retrieves detailed information about a specific asset using its unique ID.

```APIDOC
## GET /info/{id}

### Description
Fetches detailed information about a specific asset identified by its unique ID or slug.

### Method
GET

### Endpoint
/info/{id}

### Parameters
#### Path Parameters
- **id** (string) - Required - The unique ID or slug of the asset (e.g., `abandoned_factory_canteen_01`).

### Request Example
```
GET /info/abandoned_factory_canteen_01
```

### Response
#### Success Response (200)
- **asset_info** (object) - An object containing the metadata for the specified asset.

#### Response Example
```json
{
  "id": "abandoned_factory_canteen_01",
  "name": "Abandoned Factory Canteen 01",
  "type": "hdris",
  "categories": ["interior", "industrial", "abandoned"],
  "url": "https://polyhaven.com/hdris/abandoned_factory_canteen_01"
}
```
```

--------------------------------

### GET /assets

Source: https://api.polyhaven.com/api-docs/swagger

Retrieves a list of all available assets. This endpoint provides a comprehensive overview of the assets, including their names, types, publication dates, download counts, and URLs for thumbnails. It's useful for browsing or fetching a large dataset of assets.

```APIDOC
## GET /assets

### Description
Retrieves a list of all available assets, including details like name, type, publication date, download count, and thumbnail URL.

### Method
GET

### Endpoint
/assets

### Parameters
#### Query Parameters
- **type** (integer) - Optional - Filter assets by type (0: HDRIs, 1: Textures, 2: Models).
- **sort** (string) - Optional - Sort order for results (e.g., 'popular', 'newest').
- **categories** (string) - Optional - Comma-separated list of categories to filter by.

### Request Example
```
GET /assets?type=1&sort=popular&categories=asphalt,outdoor
```

### Response
#### Success Response (200)
- **assets** (object) - An object where keys are asset IDs and values are asset details.
  - **assetID** (object) - Detailed information about a specific asset.
    - **name** (string) - The human-readable name of the asset.
    - **type** (integer) - The type of asset (0: HDRI, 1: Texture, 2: Model).
    - **date_published** (integer) - The epoch timestamp of publication.
    - **download_count** (integer) - The number of downloads.
    - **files_hash** (string) - SHA1 hash of the files object.
    - **authors** (object) - An object mapping author names to their contributions.
    - **donated** (boolean, nullable) - Indicates if the asset was donated.
    - **categories** (array of strings) - List of categories the asset belongs to.
    - **tags** (array of strings) - List of tags for the asset.
    - **max_resolution** (array of integers) - The highest available resolution in pixels.
    - **thumbnail_url** (string) - URL for the asset's thumbnail.

#### Response Example
```json
{
  "aerial_asphalt_01": {
    "name": "Aerial Asphalt 01",
    "type": 1,
    "date_published": 1597061145,
    "download_count": 33151,
    "files_hash": "f55493e46c51f95b51bb5952d0b38d634937f3b2",
    "authors": {
      "Rob Tuytel": "All"
    },
    "categories": [
      "asphalt",
      "outdoor",
      "floor",
      "road",
      "man made"
    ],
    "tags": [
      "road",
      "flat",
      "cracked"
    ],
    "max_resolution": [
      8192,
      8192
    ],
    "dimensions": [
      30000,
      30000
    ],
    "thumbnail_url": "https://cdn.polyhaven.com/asset_img/thumbs/aerial_asphalt_01.png?width=256&height=256"
  },
  "aerial_beach_01": {
    "name": "Aerial Beach 01",
    "type": 1,
    "date_published": 1601489165,
    "download_count": 33556,
    "files_hash": "8746a9a941bebe5743d0a710e11cb91beb225ca6",
    "authors": {
      "Rob Tuytel": "All"
    },
    "categories": [
      "terrain",
      "sand",
      "outdoor",
      "natural"
    ],
    "tags": [
      "beach",
      "wavy",
      "costal",
      "ocean",
      "seaside"
    ],
    "max_resolution": [
      16384,
      16384
    ],
    "dimensions": [
      30000,
      30000
    ],
    "thumbnail_url": "https://cdn.polyhaven.com/asset_img/thumbs/aerial_beach_01.png?width=256&height=256"
  }
}
```
```

--------------------------------

### Get Author Information

Source: https://api.polyhaven.com/api-docs/swagger

Retrieves information about a specific author using their unique ID.

```APIDOC
## GET /author/{id}

### Description
Fetches information about a specific author, including their display name, links, and contact details if available.

### Method
GET

### Endpoint
/author/{id}

### Parameters
#### Path Parameters
- **id** (string) - Required - The unique ID of the author (e.g., `Andreas Mischok`).

### Request Example
```
GET /author/Andreas Mischok
```

### Response
#### Success Response (200)
- **author_info** (object) - An object containing details about the author.

#### Response Example
```json
{
  "id": "Andreas Mischok",
  "name": "Andreas Mischok",
  "url": "https://polyhaven.com/ AndreasMischok",
  "email": "info@polyhaven.com"
}
```
```

--------------------------------

### GET /assets/categories

Source: https://api.polyhaven.com/api-docs/swagger

Retrieves a count of assets for each available category. This endpoint is useful for understanding the distribution of assets across different categories and for displaying category-specific information or filters.

```APIDOC
## GET /assets/categories

### Description
Retrieves a count of assets for each available category.

### Method
GET

### Endpoint
/assets/categories

### Parameters
None

### Request Example
```
GET /assets/categories
```

### Response
#### Success Response (200)
- **content** (object) - An object where keys are category names and values are the count of assets in that category.

#### Response Example
```json
{
  "all": 512,
  "natural light": 434,
  "outdoor": 377,
  "urban": 272,
  "nature": 265,
  "low contrast": 188,
  "high contrast": 182,
  "morning-afternoon": 181,
  "partly cloudy": 171,
  "medium contrast": 141,
  "indoor": 140,
  "skies": 130,
  "clear": 117,
  "sunrise-sunset": 114,
  "midday": 103,
  "artificial light": 103,
  "overcast": 76,
  "night": 31,
  "studio": 18
}
```
```

--------------------------------

### List Assets

Source: https://api.polyhaven.com/api-docs/swagger

Retrieves a list of assets with their metadata. Supports filtering by asset type and categories.

```APIDOC
## GET /assets

### Description
Returns a list of assets, including their metadata. This endpoint supports filtering by asset type and categories.

### Method
GET

### Endpoint
/assets

### Parameters
#### Query Parameters
- **type** (string) - Optional - Filter to assets of a particular type. Can be `hdris`/`textures`/`models`/`all`.
- **categories** (string) - Optional - A comma-separated list of categories to filter by. Only assets that match all specified categories will be included.

### Request Example
```
GET /assets?type=textures&categories=brick
```

### Response
#### Success Response (200)
- **assets** (object) - An object containing a list of assets matching the query parameters.

#### Response Example
```json
{
  "assets": [
    {
      "id": "brick_wall_01",
      "name": "Brick Wall 01",
      "type": "textures",
      "categories": ["brick", "wall", "exterior"],
      "url": "https://polyhaven.com/textures/brick_wall_01"
    }
  ]
}
```
```

--------------------------------

### List Categories

Source: https://api.polyhaven.com/api-docs/swagger

Retrieves a list of available categories for a specified asset type, including the count of assets in each category. Can also list asset types if 'all' is provided.

```APIDOC
## GET /categories/{type}

### Description
Lists categories for a given asset type. If `all` is passed as the type, it returns a list of asset types with their counts.

### Method
GET

### Endpoint
/categories/{type}

### Parameters
#### Path Parameters
- **type** (string) - Required - One of the supported asset types: `hdris`, `textures`, or `models`.

#### Query Parameters
- **in** (string) - Optional - A comma-separated list of categories. Filters the results to include only categories that contain assets also present in the specified list.

### Request Example
```
GET /categories/hdris
GET /categories/hdris?in=night,clear
GET /categories/all
```

### Response
#### Success Response (200)
- **categories_list** (array) - An array of category objects, each containing the category name and asset count.

#### Response Example
```json
[
  {"name": "outdoor", "count": 150},
  {"name": "indoor", "count": 75}
]
```
```

--------------------------------

### Model Asset Details

Source: https://api.polyhaven.com/api-docs/swagger

Retrieves detailed information about a 3D model asset, including its categories, tags, and available LODs.

```APIDOC
## GET /api/v1/asset/model/{asset_id}

### Description
Retrieves detailed information about a specific 3D model asset.

### Method
GET

### Endpoint
/api/v1/asset/model/{asset_id}

### Parameters
#### Path Parameters
- **asset_id** (string) - Required - The unique identifier for the model asset.

#### Query Parameters
None

### Request Example
None (GET request with path parameter)

### Response
#### Success Response (200)
- **name** (string) - The human-readable name of the model.
- **type** (integer) - The asset type, for models this is 2.
- **date_published** (integer) - The epoch timestamp in seconds of when the asset was published.
- **download_count** (integer) - The number of times this asset was downloaded.
- **files_hash** (string) - A SHA1 hash of the files object.
- **authors** (object) - An object detailing the creators and their contributions.
- **donated** (boolean) - Whether the asset was donated.
- **categories** (array) - An array of categories the asset belongs to.
- **tags** (array) - An array of tags for search matching.
- **max_resolution** (array) - The maximum texture resolution available for this model.
- **lods** (array) - A list of LOD triangle counts in order (optional).
- **thumbnail_url** (string) - The URL of the preview image thumbnail.

#### Response Example
```json
{
  "name": "Horse Statue 01",
  "type": 2,
  "date_published": 1634860800,
  "download_count": 12345,
  "files_hash": "8746a9a941bebe5743d0a710e11cb91beb225ca6",
  "authors": {
    "Rico Cilliers": "All"
  },
  "donated": false,
  "categories": [
    "props",
    "decorative"
  ],
  "tags": [
    "decorative",
    "horse",
    "statue",
    "figurine",
    "porcelain",
    "animal",
    "sculpture",
    "white",
    "fancy"
  ],
  "max_resolution": [
    8192,
    8192
  ],
  "lods": [
    20000,
    10000,
    5000,
    2000,
    1000
  ],
  "thumbnail_url": "https://cdn.polyhaven.com/asset_img/thumbs/horse_statue_01.png?width=256&height=256"
}
```
```

--------------------------------

### List Asset Types

Source: https://api.polyhaven.com/api-docs/swagger

Retrieves a list of all available asset types on Poly Haven. Currently supported types are 'hdris', 'textures', and 'models'.

```APIDOC
## GET /types

### Description
Lists the available asset types on Poly Haven.

### Method
GET

### Endpoint
/types

### Parameters
None

### Request Example
None

### Response
#### Success Response (200)
- **type** (array) - An array of strings representing the available asset types.

#### Response Example
```json
["hdris", "textures", "models"]
```
```

--------------------------------

### Texture Asset Details

Source: https://api.polyhaven.com/api-docs/swagger

Retrieves detailed information about a texture asset, including its dimensions, categories, and tags.

```APIDOC
## GET /api/v1/asset/texture/{asset_id}

### Description
Retrieves detailed information about a specific texture asset.

### Method
GET

### Endpoint
/api/v1/asset/texture/{asset_id}

### Parameters
#### Path Parameters
- **asset_id** (string) - Required - The unique identifier for the texture asset.

#### Query Parameters
None

### Request Example
None (GET request with path parameter)

### Response
#### Success Response (200)
- **name** (string) - The human-readable name of the texture.
- **type** (integer) - The asset type, for textures this is 1.
- **date_published** (integer) - The epoch timestamp in seconds of when the asset was published.
- **download_count** (integer) - The number of times this asset was downloaded.
- **files_hash** (string) - A SHA1 hash of the files object.
- **authors** (object) - An object detailing the creators and their contributions.
- **donated** (boolean) - Whether the asset was donated.
- **categories** (array) - An array of categories the asset belongs to.
- **tags** (array) - An array of tags for search matching.
- **max_resolution** (array) - The maximum resolution of the texture in pixels.
- **thumbnail_url** (string) - The URL of the preview image thumbnail.
- **dimensions** (array) - The dimensions of the asset in millimeters.

#### Response Example
```json
{
  "name": "Brick Floor 003",
  "type": 1,
  "date_published": 1618385199,
  "download_count": 12345,
  "files_hash": "8746a9a941bebe5743d0a710e11cb91beb225ca6",
  "authors": {
    "Dimitrios Savva": "Photography",
    "Rob Tuytel": "Processing"
  },
  "donated": false,
  "categories": [
    "floor",
    "brick",
    "man made",
    "outdoor",
    "indoor",
    "clean",
    "wall"
  ],
  "tags": [
    "brown",
    "floor",
    "pavement"
  ],
  "max_resolution": [
    8192,
    8192
  ],
  "thumbnail_url": "https://cdn.polyhaven.com/asset_img/thumbs/brick_floor_003.png?width=256&height=256",
  "dimensions": [
    2000,
    2000
  ]
}
```
```

--------------------------------

### HDRI Asset Details

Source: https://api.polyhaven.com/api-docs/swagger

Retrieves detailed information about an HDRI asset, including its resolution, white balance, and capture details.

```APIDOC
## GET /api/v1/asset/hdri/{asset_id}

### Description
Retrieves detailed information about a specific HDRI asset.

### Method
GET

### Endpoint
/api/v1/asset/hdri/{asset_id}

### Parameters
#### Path Parameters
- **asset_id** (string) - Required - The unique identifier for the HDRI asset.

#### Query Parameters
None

### Request Example
None (GET request with path parameter)

### Response
#### Success Response (200)
- **name** (string) - The human-readable name of the HDRI.
- **type** (integer) - The asset type, for HDRIs this is 0.
- **date_published** (integer) - The epoch timestamp in seconds of when the asset was published.
- **download_count** (integer) - The number of times this asset was downloaded.
- **files_hash** (string) - A SHA1 hash of the files object.
- **authors** (object) - An object detailing the creators and their contributions.
- **donated** (boolean) - Whether the asset was donated.
- **categories** (array) - An array of categories the asset belongs to.
- **tags** (array) - An array of tags for search matching.
- **max_resolution** (array) - The maximum resolution of the HDRI in pixels.
- **thumbnail_url** (string) - The URL of the preview image thumbnail.
- **whitebalance** (integer) - The whitebalance in Kelvin (optional).
- **backplates** (boolean) - Whether backplates are available (optional).
- **evs_cap** (integer) - The number of exposure brackets captured.
- **coords** (array) - Decimal lat/lon GPS coordinates (optional).
- **date_taken** (integer) - Legacy timestamp of when the HDRI was taken (deprecated).

#### Response Example
```json
{
  "name": "Abandoned Factory Canteen 01",
  "type": 0,
  "date_published": 1618385199,
  "download_count": 12345,
  "files_hash": "8746a9a941bebe5743d0a710e11cb91beb225ca6",
  "authors": {
    "Rob Tuytel": "Photography"
  },
  "donated": false,
  "categories": [
    "interior",
    "industrial",
    "abandoned"
  ],
  "tags": [
    "factory",
    "canteen",
    "abandoned",
    "industrial",
    "interior",
    "concrete",
    "metal"
  ],
  "max_resolution": [
    16384,
    8192
  ],
  "thumbnail_url": "https://cdn.polyhaven.com/asset_img/thumbs/abandoned_factory_canteen_01.png?width=256&height=256",
  "whitebalance": 5450,
  "backplates": true,
  "evs_cap": 15,
  "coords": [
    50.995194,
    35.105417
  ],
  "date_taken": 1591789620
}
```
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.