Get asset

GET

assets

{asset_id}

Get asset

curl --request GET \
  --url https://api.fal.ai/v1/assets/{asset_id} \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.fal.ai/v1/assets/{asset_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "asset": {
    "asset_id": "d8b6elcregj72v34jr8g",
    "vector_id": "b1a2b4a5-cb89-51dc-a108-6dbfd8e742fc",
    "request_id": "019e6d0a-e5be-7b82-b329-35ae64296902",
    "url": "https://v3b.fal.media/files/b/0a9b4900/PDbTGyzqRh1aijW2WQiY9_opengraph-1%20%281%29.png",
    "type": "image",
    "title": "Cinematic portrait",
    "endpoint": "fal-ai/flux/dev",
    "created_at": "2026-05-23T20:00:00.000Z",
    "source": "upload",
    "prompt": "cinematic portrait of a character",
    "width": 1024,
    "height": 1024,
    "content_type": "image/png",
    "is_favorited": false,
    "collection_ids": [
      "d8b6elcregj72v34jr8g"
    ],
    "tags": [
      {
        "id": "d9k7q2m4n6p8r1s3t5uv",
        "name": "moodboard",
        "created_at": "2026-05-23T20:00:00.000Z"
      }
    ],
    "similarity": 0.92
  }
}

{
  "error": {
    "type": "validation_error",
    "message": "Invalid request parameters"
  }
}

{
  "error": {
    "type": "authorization_error",
    "message": "Authentication required"
  }
}

{
  "error": {
    "type": "authorization_error",
    "message": "Access denied"
  }
}

{
  "error": {
    "type": "not_found",
    "message": "Resource not found"
  }
}

{
  "error": {
    "type": "validation_error",
    "message": "Invalid request parameters"
  }
}

{
  "error": {
    "type": "validation_error",
    "message": "Invalid request parameters"
  }
}

{
  "error": {
    "type": "rate_limited",
    "message": "Rate limit exceeded"
  }
}

{
  "error": {
    "type": "server_error",
    "message": "An unexpected error occurred"
  }
}

{
  "error": {
    "type": "server_error",
    "message": "Upstream asset service failed"
  }
}

Authorizations

Authorization

string

header

required

Key on the READONLY preset, or any key whose permissions include the ones this API lists. Prefix it with "Key ", e.g. Authorization: Key YOUR_API_KEY

Path Parameters

asset_id

string

required

Asset ID. A vector ID is also accepted

Minimum string length: 1

Example:

"d8b6elcregj72v34jr8g"

Response

Asset details

asset

object

required

Asset details

Hide child attributes

asset.asset_id

string | null

required

Asset ID (canonical catalog identity)

Example:

"d8b6elcregj72v34jr8g"

asset.vector_id

string

required

Vector ID. Prefer asset_id for addressing

Example:

"b1a2b4a5-cb89-51dc-a108-6dbfd8e742fc"

asset.request_id

string | null

required

Request ID

Example:

"019e6d0a-e5be-7b82-b329-35ae64296902"

asset.url

string | null

required

Media URL

Example:

"https://v3b.fal.media/files/b/0a9b4900/PDbTGyzqRh1aijW2WQiY9_opengraph-1%20%281%29.png"

asset.type

enum<string>

required

Asset media type

Available options:

image,

video,

audio,

3d

asset.title

string

required

Display title

Example:

"Portrait"

asset.endpoint

string | null

required

Model endpoint that produced the asset

Example:

"fal-ai/flux/dev"

asset.created_at

string | null

required

Asset creation time

Example:

"2026-05-23T20:00:00.000Z"

asset.source

string | null

required

Asset source

Example:

"upload"

asset.prompt

string | null

required

Saved prompt or description

Example:

"cinematic portrait"

asset.width

number | null

required

Width in pixels

Example:

1024

asset.height

number | null

required

Height in pixels

Example:

1024

asset.content_type

string | null

required

Media content type

Example:

"image/png"

asset.is_favorited

boolean

required

Whether the asset is favorited

Example:

false

asset.collection_ids

string[]

required

Collections containing this asset

Example:

["d8b6elcregj72v34jr8g"]

asset.tags

object[]

required

Assigned tags

Hide child attributes

asset.tags.id

string

required

Tag ID

Example:

"d9k7q2m4n6p8r1s3t5uv"

asset.tags.name

string

required

Tag name

Example:

"moodboard"

asset.tags.created_at

string | null

required

Tag creation time

Example:

"2026-05-23T20:00:00.000Z"

asset.similarity

number | null

required

Semantic similarity score when applicable

Example:

0.92

⌘I

Get asset

curl --request GET \
  --url https://api.fal.ai/v1/assets/{asset_id} \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.fal.ai/v1/assets/{asset_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "asset": {
    "asset_id": "d8b6elcregj72v34jr8g",
    "vector_id": "b1a2b4a5-cb89-51dc-a108-6dbfd8e742fc",
    "request_id": "019e6d0a-e5be-7b82-b329-35ae64296902",
    "url": "https://v3b.fal.media/files/b/0a9b4900/PDbTGyzqRh1aijW2WQiY9_opengraph-1%20%281%29.png",
    "type": "image",
    "title": "Cinematic portrait",
    "endpoint": "fal-ai/flux/dev",
    "created_at": "2026-05-23T20:00:00.000Z",
    "source": "upload",
    "prompt": "cinematic portrait of a character",
    "width": 1024,
    "height": 1024,
    "content_type": "image/png",
    "is_favorited": false,
    "collection_ids": [
      "d8b6elcregj72v34jr8g"
    ],
    "tags": [
      {
        "id": "d9k7q2m4n6p8r1s3t5uv",
        "name": "moodboard",
        "created_at": "2026-05-23T20:00:00.000Z"
      }
    ],
    "similarity": 0.92
  }
}

{
  "error": {
    "type": "validation_error",
    "message": "Invalid request parameters"
  }
}

{
  "error": {
    "type": "authorization_error",
    "message": "Authentication required"
  }
}

{
  "error": {
    "type": "authorization_error",
    "message": "Access denied"
  }
}

{
  "error": {
    "type": "not_found",
    "message": "Resource not found"
  }
}

{
  "error": {
    "type": "validation_error",
    "message": "Invalid request parameters"
  }
}

{
  "error": {
    "type": "validation_error",
    "message": "Invalid request parameters"
  }
}

{
  "error": {
    "type": "rate_limited",
    "message": "Rate limit exceeded"
  }
}

{
  "error": {
    "type": "server_error",
    "message": "An unexpected error occurred"
  }
}

{
  "error": {
    "type": "server_error",
    "message": "Upstream asset service failed"
  }
}