# Get a DAM asset by ID

Retrieves a single DAM asset by its entity ID with core members and independently selected fields, taxonomies, relations, renditions and expansions. Each omitted selector returns its full caller-visible section; a present but empty selector loads none of that section. Selecting one section does not change the defaults of the others. `fields` selects entries in the response `fields` map, as in search. With no selectors, the response is fully hydrated.

Endpoint: GET /api/v1/dam/assets/{id}
Version: v1.0
Security: OAuth2

## Security:

  - `OAuth2` (unknown)
    oauth2

## Path parameters:

  - `id` (integer, required)
    Asset entity ID.

## Query parameters:

  - `culture` (string)
    Culture/language code used to localize multilingual returned values, for example `en-US`. Defaults to the caller's preferred culture, falling back to `en-US`.

  - `fields` (array)
    Comma-separated canonical field keys from context, matching search include.fields and returned in the response fields map. Omitted returns all visible fields; fields= loads none and returns fields as an empty map. Does not change other selectors. Unknown, invisible, misplaced or repeated keys return 400 UNKNOWN_INCLUDE. Core members remain present.

  - `taxonomies` (array)
    Comma-separated canonical taxonomy keys from context, matching search include.taxonomies. Omitted returns all visible taxonomy members; taxonomies= loads none and returns an empty map. Does not change other selectors. Unknown, invisible, misplaced or repeated keys return 400 UNKNOWN_INCLUDE.

  - `relations` (array)
    Comma-separated canonical relation keys from context, matching search include.relations. Omitted returns all visible relation members; relations= loads none and returns an empty map. Does not change other selectors. Unknown, invisible, misplaced or repeated keys return 400 UNKNOWN_INCLUDE. CollectionToAsset memberships belong in collections.

  - `renditions` (array)
    Comma-separated configured rendition keys, matching search include.renditions. Omitted selects all configured renditions; renditions= loads none and returns an empty map. Does not change other selectors. Unknown or repeated keys return 400 UNKNOWN_INCLUDE; configured keys unavailable for this asset are omitted from the map.

  - `expansions` (array)
    Comma-separated on-demand sections that are not asset members: publicLinks, collections. Omitted returns every available expansion; expansions= loads and returns none. Does not change other selectors. Unknown or repeated values return 400 UNKNOWN_INCLUDE.

## Response 200:

  - `200` (unknown)
    Successful operation

## Response 200 fields (application/json):

  - `culture` (string, required)
    Effective culture used to localize returned values.

  - `id` (integer, required)
    Asset entity ID.

  - `identifier` (string, required)
    Asset identifier.

  - `title` (string)
    Asset display title.

  - `fileName` (string)
    Asset file name.

  - `assetType` (any)
    Asset type identifier and localized label.

  - `assetType.id` (integer, required)
    Related entity ID.

  - `assetType.identifier` (string, required)
    Canonical related entity identifier.

  - `assetType.label` (string)
    Display label resolved from the configured display-template properties.  Multilingual properties use the effective culture with `en-US` fallback;  invariant properties use their stored value. Null when no display text can be resolved.

  - `mediaType` (any)
    Asset media type identifier and localized label.

  - `fileSize` (integer)
    Asset file size in bytes.

  - `width` (integer)
    Asset width in pixels.

  - `height` (integer)
    Asset height in pixels.

  - `createdOn` (string)
    Asset creation timestamp.

  - `lifecycleStatus` (any)
    Asset lifecycle status identifier and localized label.

  - `thumbnailUrl` (string)
    Primary thumbnail URL for the asset. Always returned when the asset has a thumbnail, independent of the `renditions` selector.

  - `description` (string)
    Asset description.

  - `fields` (object, required)
    Custom property and option-list values keyed by member name. Defaults to all visible fields; the `fields` query parameter narrows it and an empty value returns an empty map. Multilingual values are resolved to the  effective culture and are omitted when that culture has no value;  other values keep their stored JSON type. Members the asset carries  no value for are omitted.

  - `taxonomies` (object, required)
    Taxonomy values keyed by canonical taxonomy key. Defaults to all visible taxonomy members; the `taxonomies` query parameter narrows it and an empty value returns an empty map. A taxonomy the asset has no value for is omitted from the map.

  - `relations` (object, required)
    Related entities keyed by canonical relation key. Defaults to all visible relation members; the `relations` query parameter narrows it and an empty value returns an empty map. The `CollectionToAsset` relation is never returned here; it is the `collections` expansion.

  - `renditions` (object, required)
    Rendition metadata keyed by configured rendition name. Defaults to all configured renditions; the `renditions` query parameter narrows it and an empty value returns an empty map. A configured rendition that is unavailable for this asset is omitted, so the map may be empty. `thumbnail` appears here only when the tenant configures it; `thumbnailUrl` carries its URL either way.

  - `publicLinks` (array)
    Existing completed, enabled and non-expired public links to the asset. Present when the `publicLinks` expansion is selected (the default); empty when the asset has none.

  - `publicLinks.relativeUrl` (string, required)
    Public-link path relative to the Content Hub origin, not a gateway routing prefix.

  - `publicLinks.expiresOn` (string)

  - `publicLinks.resourceName` (string)

  - `collections` (array)
    Caller-visible `CollectionToAsset` memberships. Present when the `collections` expansion is selected (the default); empty when none are visible.

## Response 400:

  - `400` (unknown)
    Facade validation failures use ErrorResponse. Framework model-state failures use a parameter-to-messages dictionary. UNKNOWN_INCLUDE for an unknown, invisible, misplaced or repeated selector value.

## Response 400 fields (application/problem+json):

  - `type` (string)
    Generic RFC 7231 status-code reference, shared across codes. Never branch on this; branch on `code`.

  - `title` (string)
    Stable per `code`.

  - `status` (integer, required)

  - `detail` (string)
    Occurrence-specific explanation.

  - `instance` (string)
    The request path that produced this occurrence.

  - `code` (string, required)
    Stable identifier. Never reworded or renumbered once shipped. Search validation codes: `INVALID_VALUE`, `UNKNOWN_FILTER`, `NOT_FILTERABLE`, `UNSUPPORTED_OPERATOR`, `UNRESOLVED_FILTER`, `UNKNOWN_INCLUDE`, `UNKNOWN_SORT`, `NOT_VISUALLY_INDEXED`, and `USAGE_RIGHTS_UNAVAILABLE`. GET-by-ID validation uses `INVALID_VALUE` or `UNKNOWN_INCLUDE`; missing or invisible assets return `ASSET_NOT_FOUND`. Search service failures use `VISUAL_SEARCH_UNAVAILABLE` or `SERVICE_UNAVAILABLE`. Unhandled endpoint failures use `INTERNAL_ERROR`. Authentication, authorization, and platform throttling errors are handled separately.

  - `category` (string)
    Omitted for timeout, rate-limit, dependency, or internal failures.
    Enum: "auth", "precondition", "not_found", "ambiguous", "validation", "conflict", "policy", "unsupported"

  - `requiredNextStep` (object)
    A suggested API request to resolve the error, when available. Invalid taxonomy values link to the corresponding taxonomy-value lookup. Usage-rights availability and other validation failures link to the [DAM Context API](/dam/context-api). An invalid asset ID links to asset search.

  - `requiredNextStep.operationId` (string, required)

  - `requiredNextStep.method` (string, required)
    Enum: "GET", "POST", "PUT", "PATCH", "DELETE"

  - `requiredNextStep.href` (string, required)

  - `requiredNextStep.reason` (string, required)

  - `errors` (object)
    Parameter name to human-readable messages.

  - `invalidParams` (array)

  - `invalidParams.parameter` (string)

  - `invalidParams.value` (string)
    The offending value as received, when applicable.

  - `invalidParams.reason` (string)
    Enum: "no_match", "ambiguous", "wrong_taxonomy", "unparseable", "operator_not_supported", "not_filterable", "out_of_range"

  - `invalidParams.candidates` (array)

  - `traceId` (string)

## Response 401:

  - `401` (unknown)
    Handled by existing authentication before endpoint access checks. These endpoints do not define or change the authentication error body.

## Response 403:

  - `403` (unknown)
    Access denied after successful authentication. Never returned for a malformed request.

## Response 403 fields (application/problem+json):

  - `type` (string)
    Generic RFC 7231 status-code reference, shared across codes. Never branch on this; branch on `code`.

  - `title` (string)
    Stable per `code`.

  - `status` (integer, required)

  - `detail` (string)
    Occurrence-specific explanation.

  - `instance` (string)
    The request path that produced this occurrence.

  - `code` (string, required)
    Stable identifier. Never reworded or renumbered once shipped. Search validation codes: `INVALID_VALUE`, `UNKNOWN_FILTER`, `NOT_FILTERABLE`, `UNSUPPORTED_OPERATOR`, `UNRESOLVED_FILTER`, `UNKNOWN_INCLUDE`, `UNKNOWN_SORT`, `NOT_VISUALLY_INDEXED`, and `USAGE_RIGHTS_UNAVAILABLE`. GET-by-ID validation uses `INVALID_VALUE` or `UNKNOWN_INCLUDE`; missing or invisible assets return `ASSET_NOT_FOUND`. Search service failures use `VISUAL_SEARCH_UNAVAILABLE` or `SERVICE_UNAVAILABLE`. Unhandled endpoint failures use `INTERNAL_ERROR`. Authentication, authorization, and platform throttling errors are handled separately.

  - `category` (string)
    Omitted for timeout, rate-limit, dependency, or internal failures.
    Enum: "auth", "precondition", "not_found", "ambiguous", "validation", "conflict", "policy", "unsupported"

  - `requiredNextStep` (object)
    A suggested API request to resolve the error, when available. Invalid taxonomy values link to the corresponding taxonomy-value lookup. Usage-rights availability and other validation failures link to the [DAM Context API](/dam/context-api). An invalid asset ID links to asset search.

  - `requiredNextStep.operationId` (string, required)

  - `requiredNextStep.method` (string, required)
    Enum: "GET", "POST", "PUT", "PATCH", "DELETE"

  - `requiredNextStep.href` (string, required)

  - `requiredNextStep.reason` (string, required)

  - `errors` (object)
    Parameter name to human-readable messages.

  - `invalidParams` (array)

  - `invalidParams.parameter` (string)

  - `invalidParams.value` (string)
    The offending value as received, when applicable.

  - `invalidParams.reason` (string)
    Enum: "no_match", "ambiguous", "wrong_taxonomy", "unparseable", "operator_not_supported", "not_filterable", "out_of_range"

  - `invalidParams.candidates` (array)

  - `traceId` (string)

## Response 404:

  - `404` (unknown)
    The asset does not exist or is not visible to the caller.

## Response 404 fields (application/problem+json):

  - `type` (string)
    Generic RFC 7231 status-code reference, shared across codes. Never branch on this; branch on `code`.

  - `title` (string)
    Stable per `code`.

  - `status` (integer, required)

  - `detail` (string)
    Occurrence-specific explanation.

  - `instance` (string)
    The request path that produced this occurrence.

  - `code` (string, required)
    Stable identifier. Never reworded or renumbered once shipped. Search validation codes: `INVALID_VALUE`, `UNKNOWN_FILTER`, `NOT_FILTERABLE`, `UNSUPPORTED_OPERATOR`, `UNRESOLVED_FILTER`, `UNKNOWN_INCLUDE`, `UNKNOWN_SORT`, `NOT_VISUALLY_INDEXED`, and `USAGE_RIGHTS_UNAVAILABLE`. GET-by-ID validation uses `INVALID_VALUE` or `UNKNOWN_INCLUDE`; missing or invisible assets return `ASSET_NOT_FOUND`. Search service failures use `VISUAL_SEARCH_UNAVAILABLE` or `SERVICE_UNAVAILABLE`. Unhandled endpoint failures use `INTERNAL_ERROR`. Authentication, authorization, and platform throttling errors are handled separately.

  - `category` (string)
    Omitted for timeout, rate-limit, dependency, or internal failures.
    Enum: "auth", "precondition", "not_found", "ambiguous", "validation", "conflict", "policy", "unsupported"

  - `requiredNextStep` (object)
    A suggested API request to resolve the error, when available. Invalid taxonomy values link to the corresponding taxonomy-value lookup. Usage-rights availability and other validation failures link to the [DAM Context API](/dam/context-api). An invalid asset ID links to asset search.

  - `requiredNextStep.operationId` (string, required)

  - `requiredNextStep.method` (string, required)
    Enum: "GET", "POST", "PUT", "PATCH", "DELETE"

  - `requiredNextStep.href` (string, required)

  - `requiredNextStep.reason` (string, required)

  - `errors` (object)
    Parameter name to human-readable messages.

  - `invalidParams` (array)

  - `invalidParams.parameter` (string)

  - `invalidParams.value` (string)
    The offending value as received, when applicable.

  - `invalidParams.reason` (string)
    Enum: "no_match", "ambiguous", "wrong_taxonomy", "unparseable", "operator_not_supported", "not_filterable", "out_of_range"

  - `invalidParams.candidates` (array)

  - `traceId` (string)

## Response 429:

  - `429` (unknown)
    Rate limited by the platform throttling middleware when throttling is enabled for the environment. The body is a plain-text message, not an ErrorResponse. Retry after the `Retry-After` header.

## Response 429 headers (text/plain):

  - `Retry-After` (integer)
    Seconds to wait before retrying.

## Response 500:

  - `500` (unknown)
    Internal error.

## Response 500 fields (application/problem+json):

  - `type` (string)
    Generic RFC 7231 status-code reference, shared across codes. Never branch on this; branch on `code`.

  - `title` (string)
    Stable per `code`.

  - `status` (integer, required)

  - `detail` (string)
    Occurrence-specific explanation.

  - `instance` (string)
    The request path that produced this occurrence.

  - `code` (string, required)
    Stable identifier. Never reworded or renumbered once shipped. Search validation codes: `INVALID_VALUE`, `UNKNOWN_FILTER`, `NOT_FILTERABLE`, `UNSUPPORTED_OPERATOR`, `UNRESOLVED_FILTER`, `UNKNOWN_INCLUDE`, `UNKNOWN_SORT`, `NOT_VISUALLY_INDEXED`, and `USAGE_RIGHTS_UNAVAILABLE`. GET-by-ID validation uses `INVALID_VALUE` or `UNKNOWN_INCLUDE`; missing or invisible assets return `ASSET_NOT_FOUND`. Search service failures use `VISUAL_SEARCH_UNAVAILABLE` or `SERVICE_UNAVAILABLE`. Unhandled endpoint failures use `INTERNAL_ERROR`. Authentication, authorization, and platform throttling errors are handled separately.

  - `category` (string)
    Omitted for timeout, rate-limit, dependency, or internal failures.
    Enum: "auth", "precondition", "not_found", "ambiguous", "validation", "conflict", "policy", "unsupported"

  - `requiredNextStep` (object)
    A suggested API request to resolve the error, when available. Invalid taxonomy values link to the corresponding taxonomy-value lookup. Usage-rights availability and other validation failures link to the [DAM Context API](/dam/context-api). An invalid asset ID links to asset search.

  - `requiredNextStep.operationId` (string, required)

  - `requiredNextStep.method` (string, required)
    Enum: "GET", "POST", "PUT", "PATCH", "DELETE"

  - `requiredNextStep.href` (string, required)

  - `requiredNextStep.reason` (string, required)

  - `errors` (object)
    Parameter name to human-readable messages.

  - `invalidParams` (array)

  - `invalidParams.parameter` (string)

  - `invalidParams.value` (string)
    The offending value as received, when applicable.

  - `invalidParams.reason` (string)
    Enum: "no_match", "ambiguous", "wrong_taxonomy", "unparseable", "operator_not_supported", "not_filterable", "out_of_range"

  - `invalidParams.candidates` (array)

  - `traceId` (string)

