# Scans   Assets

#### Access assets generated from user body scans.

Use these endpoints to retrieve preview images, 3D body models and related visual assets generated for each scan. Typical use cases include powering scan galleries, 3D viewers and other visual experiences.

All Scans - Assets endpoints require the following headers:

```http
accept: application/json;v=1
authorization: Bearer {{API_KEY}}
content-type: application/json
```

Replace `{{API_KEY}}` with your Prism API key for the selected environment.

## Get asset status of a scan.

> \
> This operation provides the \*\*asset status\*\* for a specific \*\*scan\*\*, including which assets are generated and available.\
> \
> Use this endpoint to check whether visual assets like models or preview images are ready.<br>

````json
{"openapi":"3.0.3","info":{"title":"Prism Hosted API","version":"1"},"tags":[{"name":"Scans - Assets","description":"### Access assets generated from user body scans.\n\nUse these endpoints to retrieve preview images, 3D body models and related visual assets generated for each scan.\nTypical use cases include powering scan galleries, 3D viewers and other visual experiences.\n\nAll Scans - Assets endpoints require the following headers:\n```http\naccept: application/json;v=1\nauthorization: Bearer {{API_KEY}}\ncontent-type: application/json\n```\nReplace `{{API_KEY}}` with your Prism API key for the selected environment.","parent":"Scans"}],"servers":[{"url":"https://api.hosted.prismlabs.tech","description":"Production environment for Prism Hosted API"},{"url":"https://sandbox-api.hosted.prismlabs.tech","description":"Sandbox environment for Prism Hosted API"}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http","name":"Authorization","in":"header"}},"schemas":{"ScanAssetsDto":{"type":"object","properties":{"id":{"type":"string","description":"The unique ID of the scan assets"},"scanId":{"type":"string","description":"The ID of the scan associated with the assets"},"captureData":{"type":"string","nullable":true,"enum":["started","succeeded","failed"],"description":"The status of the capture data associated with the scan"},"captureDataUpdatedAt":{"type":"string","nullable":true,"description":"The date and time the capture data was last updated"},"body":{"type":"string","nullable":true,"enum":["started","succeeded","failed"],"description":"The status of the body associated with the scan"},"bodyUpdatedAt":{"type":"string","nullable":true,"description":"The date and time the body was last updated"},"fittedBody":{"type":"string","nullable":true,"enum":["started","succeeded","failed"],"description":"The status of the fitted body associated with the scan"},"fittedBodyUpdatedAt":{"type":"string","nullable":true,"description":"The date and time the fitted body was last updated"},"measurement":{"type":"string","nullable":true,"enum":["started","succeeded","failed"],"description":"The status of the measurement associated with the scan"},"measurementUpdatedAt":{"type":"string","nullable":true,"description":"The date and time the measurement was last updated"},"createdAt":{"type":"string","description":"The date and time the scan assets were created"},"updatedAt":{"type":"string","description":"The date and time the scan assets were last updated"}},"required":["id","scanId","captureData","captureDataUpdatedAt","body","bodyUpdatedAt","fittedBodyUpdatedAt","measurementUpdatedAt","createdAt","updatedAt"]}}},"paths":{"/scans/{scanId}/scan-assets":{"get":{"description":"\nThis operation provides the **asset status** for a specific **scan**, including which assets are generated and available.\n\nUse this endpoint to check whether visual assets like models or preview images are ready.\n","operationId":"ScanAssetsController_findOne","parameters":[{"name":"scanId","required":true,"in":"path","description":"The unique ID of the scan.","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json;v=1":{"schema":{"$ref":"#/components/schemas/ScanAssetsDto"}}}}},"summary":"Get asset status of a scan.","tags":["Scans - Assets"]}}}}
````

## Get asset URLs of a scan.

> \
> This operation provides the download \*\*URLs\*\* for all available \*\*assets\*\* of a specific \*\*scan\*\*.\
> \
> The response includes URLs for assets such as preview images or 3D models.<br>

````json
{"openapi":"3.0.3","info":{"title":"Prism Hosted API","version":"1"},"tags":[{"name":"Scans - Assets","description":"### Access assets generated from user body scans.\n\nUse these endpoints to retrieve preview images, 3D body models and related visual assets generated for each scan.\nTypical use cases include powering scan galleries, 3D viewers and other visual experiences.\n\nAll Scans - Assets endpoints require the following headers:\n```http\naccept: application/json;v=1\nauthorization: Bearer {{API_KEY}}\ncontent-type: application/json\n```\nReplace `{{API_KEY}}` with your Prism API key for the selected environment.","parent":"Scans"}],"servers":[{"url":"https://api.hosted.prismlabs.tech","description":"Production environment for Prism Hosted API"},{"url":"https://sandbox-api.hosted.prismlabs.tech","description":"Sandbox environment for Prism Hosted API"}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http","name":"Authorization","in":"header"}},"schemas":{"ScanAssetUrlsDto":{"type":"object","properties":{"previewImage":{"type":"string","nullable":true},"model":{"type":"string","nullable":true},"canonicalBody":{"type":"string","nullable":true},"texture":{"type":"string","nullable":true},"material":{"type":"string","nullable":true},"stripes":{"type":"string","nullable":true}},"required":["previewImage","model","canonicalBody","texture","material","stripes"]}}},"paths":{"/scans/{scanId}/asset-urls":{"get":{"description":"\nThis operation provides the download **URLs** for all available **assets** of a specific **scan**.\n\nThe response includes URLs for assets such as preview images or 3D models.\n","operationId":"ScanAssetUrlsController_findAll","parameters":[{"name":"scanId","required":true,"in":"path","description":"The unique ID of the scan.","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json;v=1":{"schema":{"$ref":"#/components/schemas/ScanAssetUrlsDto"}}}}},"summary":"Get asset URLs of a scan.","tags":["Scans - Assets"]}}}}
````

## Get specific asset URL of a scan.

> \
> This operation provides the download \*\*URL\*\* for a specific \*\*asset type\*\* of a given \*\*scan\*\*.\
> \
> Use this endpoint when you only need one asset, such as the preview image or 3D model, instead of requesting all asset URLs.<br>

````json
{"openapi":"3.0.3","info":{"title":"Prism Hosted API","version":"1"},"tags":[{"name":"Scans - Assets","description":"### Access assets generated from user body scans.\n\nUse these endpoints to retrieve preview images, 3D body models and related visual assets generated for each scan.\nTypical use cases include powering scan galleries, 3D viewers and other visual experiences.\n\nAll Scans - Assets endpoints require the following headers:\n```http\naccept: application/json;v=1\nauthorization: Bearer {{API_KEY}}\ncontent-type: application/json\n```\nReplace `{{API_KEY}}` with your Prism API key for the selected environment.","parent":"Scans"}],"servers":[{"url":"https://api.hosted.prismlabs.tech","description":"Production environment for Prism Hosted API"},{"url":"https://sandbox-api.hosted.prismlabs.tech","description":"Sandbox environment for Prism Hosted API"}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http","name":"Authorization","in":"header"}}},"paths":{"/scans/{scanId}/asset-urls/{assetType}":{"get":{"description":"\nThis operation provides the download **URL** for a specific **asset type** of a given **scan**.\n\nUse this endpoint when you only need one asset, such as the preview image or 3D model, instead of requesting all asset URLs.\n","operationId":"ScanAssetUrlsController_findOne","parameters":[{"name":"scanId","required":true,"in":"path","description":"The unique ID of the scan.","schema":{"type":"string"}},{"name":"assetType","required":true,"in":"path","description":"The specific asset type of the scan","schema":{"enum":["preview-image","model","stripes"],"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json;v=1":{"schema":{"type":"string"}}}}},"summary":"Get specific asset URL of a scan.","tags":["Scans - Assets"]}}}}
````