Skip to main content
POST
/
api
/
assets
/
exist
Check asset existence
curl --request POST \
  --url https://api.example.com/api/assets/exist \
  --header 'Content-Type: application/json' \
  --data '
{
  "checksums": [
    "<string>"
  ],
  "checksum_sha1s": [
    "<string>"
  ],
  "deviceId": "<string>",
  "deviceAssetIds": [
    "<string>"
  ]
}
'
{
  "assets": [
    {
      "id": "<string>",
      "device_asset_id": "<string>",
      "device_id": "<string>",
      "checksum": "<string>",
      "checksum_sha1": "<string>"
    }
  ]
}

Query Parameters

​
library_id
string | null

Library to check assets in (optional)

Body

application/json

Request body for checking asset existence.

​
checksums
string[] | null

List of base64-encoded SHA-256 checksums to check for existence

​
checksum_sha1s
string[] | null

List of base64-encoded SHA-1 checksums to check for existence (for Immich compatibility)

​
deviceId
string | null

Device ID to filter assets by (required with deviceAssetIds)

​
deviceAssetIds
string[] | null

List of device asset IDs to check for existence (requires deviceId)

Response

Successful Response

Response for asset existence check endpoint.

​
assets
AssetLiteResponse · object[]
required

List of assets matching the query criteria